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PREFACE 


This publication is a guide to the use 
of IBM provided cataloged procedures for 
assembling; assembling and linkage editing; 
assemoling, linkage editing, and executing 
assembler language source programs. This 
edition is oriented to the E level assem- 
bler program (the assembler) functioning in 
the IBM System/360 Operating System sequen- 
tial scheduling environment. 


Other System Reference Library publica- 
tions in the IBM System/360 Operating Sys- 
tem series provide fuller, more detailed 
discussions of the topics introduced in 
this publication: a careful reading of the 


oublication IBM System/360 Operating  Sys- 


tems Concepts _ and Facilities, Form 
C28-6535, is recommended. Knowledge of the 
assembler language is assumed. Where 


appropriate, the reader is directed to the 
£Lollowing publications: 


IBM System/360 Operating System: Job 
Control Language, Form C28-6539 


IBM System/360 Operating System: Linkage 
Editor, Form C28-6538 


Second Edition 


This edition is a reprint of C28-6595-0 and incor- 
porates changes released in Technical Newsletter 
N28-2140, dated March 31, 1966. 


Significant changes or additions to the specifica- 
tions contained in this publication will be re- 
ported in subsequent revisions or Technical 
Newsletters. 


IBM System/360 Operating System: Control 
Program Services, Form C28-6541 


IBM System/360 Operating System: Assem- 
bler Lanquage, Form C28-6514 


IBM System/360 Operating System: Utili- 
ties, Form C28-6586 


IBM System/360 Operating System: Control 


Program Messages and Completion Codes, 
Form C28~6608 


IBM System/360 Operating System: FORTRAN 


Iv. (EF), Library Subprograms, Form 
C28-6596 


IBM System/360 Operating System: System 
Programmers Guide, Form C28-6550 


IBM System/360 Operating System: FORTRAN 
IV_(E) Programmer's Guide, Form C28-6€03 


IBM Systen/360 Operating System: COBOL 
(E) Programmer's Guide, Form C24-5029 


This publication was prepared for production using an IBM computer 


to update the text and-to control the page and line format. 


Page 


impressions for photo-offset printing were obtained from an IBM 


1403 Printer using a special print chain. 


Requests for copies of IBM publications should be made to your IBM 
representative or to the IBM branch office serving your locality. 


A form is provided at the back of this publication for reader's comments. 
If the form has been removed, comments may be addressed to IBM Corporation, 
Programming Publications, Department 452, San Jose, California 95114. 


© International Business Machines Corporation 1966 
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Through the medium of job control state- 
ments, the programmer specifies job 
requirements directly to the operating sys- 
tem, thus eliminating many of the functions 
previously performed by the machine opera- 
tor or other installation personnel. The 
job consists of one or more job steps. For 
example, the job of assembling, lLinkage- 
editing, and executing a source program 
involves three job steps: 


1. Translating the source program, i.e., 
executing the assembler component of 
the operating system to produce an 
object module. 


2. Processing the output of the 
assembler, 1.@., executing the 
linkage-editor component of the oper- 


ating system to produce a load module. 


3. Executing the 
edited program, 
load module. 


assembled and linkage- 
i.e., executing the 


A procedure is a sequence of job control 
language statements specifying a job. 
Procedures may enter the system via the 
input stream or from a library of proce- 


dures, which are previously defined and 
contained in a procedure library. The 
input stream is the flow of job control 
statements and, optionally, input data 


entering the system from one input device. 
At the sequential scheduling system level 
of the operating system, only one input 
stream may exist at atime. (For a de- 
scription of the operating system environ- 


ment see IBM System/360 Operating System: 
Concepts and Facilities.) 


The job definition (JOB), execute 
(EXEC), data definition (DD), and delimiter 
(/*) job control statements are shown in 
this publication as they are used to speci- 
fy assembler processing. Detailed explana- 
tions of these statements are given in IBM 
System/360 Operating System: Job Control 
Language. 


Operating system factors influencing 
program preparation, such as program termi- 
nation, saving and restoring general reg- 
isters, and linking of independently pro- 
duced object modules are discussed in 
"Programming Considerations" as are guides 
to determine whether assembler dictionary 
sizes and source statement complexity limi- 
tations will be exceeded. 


INTRODUCTION 


The balance of this introductory section 
discusses the assembler options, data sets, 
and return codes. 


ASSEMBLER _ OPTIONS 


The programmer may specify the following 
assembler options in the PARM= field of the 
EXEC statement: 


DECK LOAD LIST TEST XREF 
PARM= (NODECK, NOLOAD, NOLIST, NOTEST, NOXREF, 
LINECNT=nn) 


These options are defined as follows: 


DECK+ -- The object module is placed on the 
device specified in the SYSPUNCH 
DD statement. 

LOAD1 -- The object module is placed on the 


device specified in the SYSPUNCH 
DD statement. 

LIST -- An assembler listing is produced. 

TEST -- The object module (if produced) 
contains the special source symbol 
table required by the test trans- 
lator (TESTRAN) routines. 

XREF -- The assembler produces a écross- 
reference table of symbols as part 


of the listing. 


The prefix NO is used with the above 
options to indicate that the option is not 
wanted. If contradictory options are 
entered, ¢.g., LIST,NOLIST, the rightmost 
option, e.g., NOLIST is used. DECK and 
LOAD can be contradictory. 


LINECNT=nn 
specifies the number of lines to be 
printed between headings in the list- 
ing. The permissible range is 01 to 
99 lines. 


4The assembler, during a single execution, 
produces either an object module in punched 
card form, or an object module in inter- 
mediate storage. The UNIT= designation in 
the SYSPUNCH DD statement determines where 
the object module is placed. Because of 


this the DECK and LOAD options are inter- 
changeable. If both are specified the 
rightmost entry is used: If DECK,NOLOAD is 


specified, no object deck is produced. 
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DEFAULT ENTRY 


If no options are specified, the assem- 
bler assumes the following defauit entry: 


PARM= (NOLOAD, DECK, LIST,NOTEST, XREF, 
LINECNT=56) 


The cataloged procedures discussed in 
this guide assume the default entry. How- 
ever, the programmer may override any or 
all of the default options (see "Overriding 
Cataloged Procedures"). 


ASSEMBLER DATA SET REQUIREMENTS 


Seven data sets must be defined for the 
assembler; they are described in the fol- 
lowing text. The ddname that must be used 
in the DD statement describing the data set 
appears as the heading for each descrip- 
tion. 


Ddname SYSLIB 


From this data set, the assembler 
obtains macro definitions and assembler 
language statements to be calied by the 


COPY assembler instruction. It is a parti- 
tioned data set and each macro definition 
or sequence of assembler statements is a 
separate member with the member name being 
the macro-instruction mnemonic or COPY code 
name. The data set may be defined as 
SYS1.MACLIB or a user's private macro defi- 
nition or COPY library. SYS1.MACLIB  con- 
tains macro definitions for the system 
Imacro-instructions provided by IBM. A 
user's private library may be concatenated 
with SYS1.MACLIB. The Job Control Language 
publication explains data set concatena- 
tion. 


Ddnames SYSUTiI, SYSUT2, SYSUT3 


These utility data sets are used by the 


assembler when processing the source pro- 
gram. The input/output device(s) assigned 
to these data sets must be capable of 


sequential access to records: the assembler 
does not support multi-volume utility data 
sets. 


Ddname SYSPRINT 


This data set is used by the assembler 
to produce a listing. Output may be 
directed to a printer or magnetic’ tape. 
The assembler uses the machine code 


carriage-control characters for this data 
set. 
Ddname SYSPUNCH 

The assembler uses this data set to 
produce the object module. The 


input/output unit assigned to this data set 
may be either a card punch or an intermedi- 
ate storage device (capable of sequential 
access). In the same execution, the assen- 
bler cannot produce a punched card object 
module and an object module on intermediate 
storage. 


Ddname SYSIN 


This data set contains the input to the 
assembler -- the source statements to be 
processed. The input/output device 
assigned to this data set is either the 
device transmitting the input stream, or a 
device designated by the programmer. The 
DD statement describing this data set usu- 
ally appears in the input stream. The IBM 
supplied procedures do not contain this 
statement. 


RETURN CODES 


Table 1 shows the return codes issued by 
the assembler for use with the COND= 
parameter? of JOB or EXEC statements. 


Table 1. 


aa 
| Return 


i 
| Code | 
+ 


Return Codes 
me ae ee es Se ee ae. + 


Explanation | 


}------}---------------------------------- { 


| 0  |no errors detected | 


[------ }-------------=-------------------- 4 


{minor errors detected; successful | 
{ | program execution is probable | 


Jerrors detected; unsuccessful | 
| | program execution is possible | 


| 12 |serious errors detected; 

| Junsuccessful program execution is | 
| | probable | 
[------ }---------------------------------- { 
| 16 |critical errors detected; normal | 


| Jexecution is impossible | 


f------ }---------------------------------- { 


| 20 |unrecoverable I/O error occurred | 
| {during assembly; assembly | 
| | terminated | 
eeiceuses pel aes et J 


+The COND parameter is explained in the Job 
Control Language publication. 


The return code issued by the assembler 
is the highest severity code that is: 


a. Associated with any error detected by 
the assembler.+t 


4See Appendix A for diagnostic messages and 
severity codes. 


b. Associated with MNOTE messages pro- 
duced by macro-instructions. 


c. Associated with an unrecoverable I/0 
error occurring during the assembly. 
The return code of 20 is used only for 


condition code testing. It is not asso- 
ciated with any diagnostic messages. 
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CATALOGED PROCEDURES 


This section describes three IBM provid- 
ed cataloged procedures: a procedure for 
assembling (ASMEC); a procedure for assem- 
bling and linkage editing (ASMECL); a pro- 
cedure for assembling, linkage editing, and 
executing (ASMECLG). The procedures’ rely 
on conventions regarding the naming of 
device classes. These conventions, shown 
in Table 2, must be incorporated into the 
system at system generation time. 


Table 2. Device Naming Conventions 


aac ALR AR AE Aa ery ee ee 1 
| Device Classname|Devices Assigned 


| 

~=--------------}----~-------=----------- { 
|SYSSQ |Any devices allowing | 
| |sequential access to | 
{ |records for reading and | 
| jwriting | 
a | aaa ACRE 
{| SYSDA | Direct-access devices | 
ses iris es i Nh Sieg te a 4 
| SYSCP |Card punches | 
1 ae a a nk eae Rae per co ey Rae a er J 
To use cataloged procedures, an EXEC 
statement (s) naming the desired 
procedure(s) is placed in the input stream 


following the JOB statement. Subsequently, 
the specified cataloged procedure is 
brought from a procedure library and merged 
into the input stream. 


The System Programmer‘s Guide discusses 
the placing of procedures in the procedure 
library. 


CATALOGED PROCEDURE FOR ASSEMBLY (ASMEC) 


This procedure requests the operating 
system to load and execute the assembler 
(IETASM). The name ASMEC must be used to 
call this procedure. The result of execu- 
tion is an object module in punched card 
form, and an assembler listing. 


In the following example, input enters 
via the input stream. The statements 
entered in the input stream to use this 
procedure are: 


//jobname JOB 


//stepname EXEC PROC=ASMEC 


//ASM.SYSIN DD * 
| 


source program statements 


7* (delimiter statement) 


The statements of the ASMEC procedure are 
brought from the procedure library and 
merged into the input stream. 


Figure 1 shows the statements that make 
up the ASMEC procedure. 


= & 


a 


fe.) 


B N 


& 


&. 


-) 


ee es ee ee ee Ee TE ce re eS I Se MS SS Se SS ee a ee ay 


//BSM EXEC PGM=IETASM 

//SYSLIB DD DSNAME=SYS1.MACLIB, DISP=OLD 
4/SYSUT1L DD UNIT=SYSSQ, SPACE= (400, (400, 50) ) 
//SYSUT2 DD UNIT=SYSSQ, SPACE= (400, (400, 50) ) 


//SYSUT3 DD UNIT= (SYSSQ, SEP=(SYSUT1,SYSUT2,SYSLIB)), x 
4/ SPACE=(400, (400,50)) 


//SYSPRINT DD SYSOUT=A 


7/SYSPUNCH DD UNIT=SYSCP 


ae ee ee ee oe en eee ee eee 


PARM= or COND= parameters may be added to this statement by the EXEC statement that 
calls the procedure (see “Overriding Cataloged Procedures"). The system name IETASM 
identifies Assembler E. 


This statement identifies the macro library data set. The data set name SYS1.MACLIB 
is an IBM designation. 


4 5 These statements specify the assembler utility data sets. The device classname 
used here, SYSSQ, may represent a collection of tape drives, or direct-access units, 
or both. The I/O units assigned to this name are specified by the installation when 
the system is generated. A unit name, e.g., 2311 may be substituted for SYSSQ. 


The SEP= subparameter in statement 5 and the SPACE= parameter in statements 3,4, and 
5 are effective only if the device assigned is a direct-access device: otherwise 
they are ignored. The space required is dependent on the make-up of the source 
program. the procedure provides an initial allocation of 160,000 bytes and 
additional allocations (if needed) of 20,000 bytes. 


This statement defines the standard system output class, SYSOUT=A, as the destina- 
tion for the assembler listing. 


This statement describes the data set that will contain the object module produced 
by the assembler. 


Figure 1. Cataloged Procedure for Assembly 


This procedure consists of two job 


steps: assembling and linkage editing. The //stepname EXEC PROC=ASMECL 
name ASMECL must be used to call this 

procedure. Execution of this procedure //3BSM.SYSIN DD * 

results in the production of an assembler | 

listing, a linkage editor listing, and a | 

load module. source program statements 


The following example assumes input to { 


the assembler via the input job stream. It /* 
also makes provision in the //LKED job step 
for concatenating the input to the linkage //LKED.SYSIN DD * 


editor from the //ASM job step with any | necessary only if 
additional linkage editor input in the | linkage-editor is 
input job stream. This additional input object module {to combine modules 


can be a previously produced object module | 
which is to be linked to the object module | 
produced by job step //ASM. /* 


Cataloged Procedures 


CATALOGED PROCEDURE FOR ASSEMBLY AND The statements entered in the input 
LINKAGE-EDITING (ASMECL) stream to use this procedure are: 
//jobname JOB 


9 


The procedure is brought from the proce- 
dure library and merged into the input 
stream. 


Figure 2 shows the statements that make 
up the ASMECL procedure. Only those state- 


ments not previously discussed are 

explained. 

poe ee oan i ow ns a on re ns nnn nes 
//BSM EXEC PGM=IETASM 


//SYSLIB DD DSNAME=SYS1.MACLIB, DISP=OLD 
//SYSUTL DD UNIT=SYSSQ, SPACE= (400, (400,50) ) 
4/SYSUT2 DD UNIT=SYSSQ,SPACE= (400, (400,50) ) 


//SYSUT3 DD UNIT= (SYSSQ, SEP= (SYSUT1,SYSUT2,SYSLIB)), Xx 
7/ SPACE=(400, (400,50) ) 


//SYSPRINT DD SYSOUT=A 


//SYSPUNCH DD DSNAME=6& LOADSET, UNIT=SYSSQ, SPACE= (80, (200,50)), x 
4/ DISP= (MOD, PASS) 


N 


//GKED EXEC PGM=IEWL, PARM=(XREF, LIST, NCAL) 


//SYSLIN DD DSNAME=&LOADSET, DISP=(OLD, DELETE) 
// DD DDNAME=SYSIN 


£ 


1 
5 //SYSLMOD DD DSNAME=&TEMP (PDS) , UNIT=SYSDA, SPACE= (1024, (50, 20,1)) 
6 //SYSUT1 DD UNIT= (SYSDA, SEP= (SYSLIN, SYSLMOD) ) , SPACE=(1024, (50,20) ) 


7 //SYSPRINT DD SYSOUT=A 


object module -- which is to be passed to the linkage editor. 

2 This statement initiates linkage editor execution. The linkage editor options in 
the PARM= field cause the linkage editor to produce a cross-reference table, module 
map, and a list of all control statements processed by the linkage editor. The NCAL 
option suppresses the automatic library call function of the linkage editor. 

|? This statement identifies the linkage editor input data set as the same one produced 
as Output by the aSsembler. 

“ This statement is used to concatenate any input to the linkage editor from the input 
stream with the input from the assembler. 

5 This statement specifies the linkage-editor output data set (the load module). As 
specified, the data set will be deleted at the end of the job. If it is desired to 
retain the load module, the DSNAME parameter must be respecified and a DISP 
parameter added. See "Overriding Catalog Procedures". If the output of the linkage 
editor is to be retained, the DSNAME parameter must specify a library name and 
member name where the load module is to be placed. The DISP parameter must specify 
either KEEP or CATLG. 

6 This statement specifies the utility data set for the linkage editor. 

7 This statement identifies the standard output class as the destination for the 
linkage editor listing. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
]}+ In this procedure the SYSPUNCH DD statement describes a temporary data set -- the 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
L 


Figure 2. Cataloged Procedure for Assembling and Linkage Editing 
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CATALOGED PROCEDURE FOR ASSEMBLY, 
LINKAGE-EDITING, AND EXECUTION (ASMECLG) 


This procedure consists of three job 
steps: assembling, linkage editing, and 
executing. The name ASMECLG must be used 


to call this procedure. Assembler and 
linkage editor listings are produced. 


The statements entered in the 
stream to use this procedure are: 


input 


//jobname JOB 


//stepname EXEC PROC=ASMECLG 


//ASM.SYSIN DD * 


| 
| 

source program statements 
| 


| 
/* 


//ULKED.SYSIN DD * 
| 
necessary only if 


object module linkage editor is 
| to combine modules 


/* 
//GO.ddname. DD (parameters) 
//GO.dadname DD (parameters) 
//GO.ddname DD * only if 
| necessary 


problem program input 
| 


| 
/* 


Figure 3 shows the statements that make 
up the ASMECLG procedure. Only those 
statements not previously discussed are 
explained in the figure. 


OVERRIDING STATEMENTS IN CATALOGED 


PROCEDURES 


EXEC and DD statements appearing in 
cataloged procedures can be overridden, in 
full or part. Such overriding of state- 
ments or fields is effective only for the 


duration of the job step in which the 
Statements appear. The statements, as 
stored in the procedure library of the 
system, remain unchanged. 


Overriding for the purposes of respeci- 
fication, addition, or nullification is 
accomplished by including in the input 
stream statements containing the desired 
changes and identifying the statements to 
be overridden. 


EXEC Statements 


The PARM= and COND= parameters can be 
added or, if present, modified by including 
in the EXEC statement calling the procedure 
the notation PARM.stepname=, or 
COND.stepname=, followed by the desired 
change. "Stepname" identifies the EXEC 
Statement within the procedure to which the 
modification applies. Overriding the PGM= 
parameter is not possible. 


If the procedure consists of more than 
one job step, a PARM. stepname= or 
COND.stepname= parameter may be entered for 
each step. The entries must be in order, 
i.e., PARM.stepl=, PARM.step2=, etc. 


DD Statements 


All parameters in the operand field of 
DD statements may be overridden by includ- 
ing in the input stream (following the EXEC 
card calling the procedure) a DD statement 
with the notation //stepname.ddname in the 
name field. "Stepname" refers to the job 
step in which the statement identified by 
"ddname" appears. 


Examples 


In the assembly procedure ASMEC (Figure 
1), the production of a punched object deck 


could be suppressed and the UNIT= and 
SPACE= parameters of data set SYSUT1 re- 
specified, by including the following 
statements in the input stream: 

//stepname EXEC PROC=ASMEC, X 
// PARM. ASM=NODECK 
//KSM.SYSUT1 DD UNIT=2311, xX 
// SPACE= (200, (300,40)) 


In procedure ASMECLG (Figure 3) sup- 
pressing production of an assembler listing 
and adding the COND= parameter to the EXEC 
statement which specifies execution of the 
linkage editor might be desired. In this 
case, the EXEC statement in the input 
stream would appear as follows: 
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//stepname EXEC PROC=ASMECLG, X if the return code issued by the assembler 
4/ PARM.ASM=NOLIST, X (step ASM) was greater then 4. 
// COND. LKED= (4, LT, ASM) 


For current execution of procedure The Job Control Language and System 
ASMECLG, no assembler listing would be Programmer's Guide publications provide 
produced, and execution of the linkage additional description of overriding tech- 
editor job step //LKED would be suppressed niques. 


//BSM EXEC PGM=IETASM 
//SYSLIB DD DSNAME=SYS1.MACLIB, DISP=OLD 
//SYSUTL DD UNIT=SYSSQ, SPACE= (400, (400,50) ) 
//SYSUT2 DD UNIT=SYSSQ,SPACE= (400, (400,50)) 
//SYSUT3 DD UNIT= (SYSSQ, SEP= (SYSUT1, SYSUT2,SYSLIB)), Xx 
1/ SPACE=(400, (400, 50)) 
//SYSPRINT DD SYSOUT=A 
//SYSPUNCH DD DSNAME=& LOADSET, UNIT=SYSSQ, SPACE= (80, (200,50)), x 
4/ DISP= (MOD, PASS) 
1 // LKED EXEC PGM=IEWL, PARM=(XREF, LET, LIST, NCAL) 


//SYSLIN DD DSNAME=& LOADSET, DISP=(OLD, DELETE) 
// DD DDNAME=SYSIN 


1%) 


4/SYSLMOD DD DSNAME=&GOSET (GO) , UNIT=SYSDA, SPACE=(1024, (50,20,1)), xX 
4/ DISP= (NEW, PASS) 


//SYSUT1 DD UNIT= (SYSDA, SEP= (SYSLIN, SYSLMOD) ) , SPACE= (1024, (50,20) ) 


//SYSPRINT DD SYSOUT=A 


i) 


4/GO EXEC PGM=*.LKED.SYSLMOD 


pb 


The LET linkage editor option specified in this statement causes the linkage editor 
to mark the load module as executable even though errors were encountered during 
processing. 


ie 


The output of the linkage editor is specified as a member of a temporary data set, 
residing on a direct-access device, and is to be passed to a succeeding job step. 


W 


This statement initiates execution of the assembled and linkage edited program. The 
notation *.LKED.SYSLMOD identifies the program to be executed as being in the data 
set described in job step LKED by the DD statement named SYSLMOD. 
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Cae cae comme Se cee cae TS eee SS ce PS gS SS ee ee gee SS capes SE cence UE ee seems SD cee EE NSD SD ee ae aD cee SS ee SD ee ES eet SD ees ES ee cee oe and) 


ot eh SS SS SS SE SS A SS A SS SD SS A GS a SS ee SSO eR A SS DS SS SS in ee SN SO i SD SS SS HS A SS SAD Se See 


Figure 3. Cataloged Procedure for Assembly, Linkage Editing, and Execution 
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The assembler listing, Figure 4, con- 
Sists of five sections, ordered as follows: 
external symbol dictionary items; the 
source and object program statements; relo- 
cation dictionary items; symbol cross- 
reference table; and diagnostic messages. 


In addition two statistical messages may 
appear in the listing. They are: 

A message if one or more Y-type address 
constants appear in the program. 


THE ASSEMBLER LISTING 


Message: AT LEAST ONE RELOCATABLE Y-TYPE 
CONSTANT IN ASSEMBLY. 


A message indicating the total number of 
statements in error. 


nnn STATEMENTS FLAGGED IN THIS 
ASSEMBLY. 


Message: 


If issued, the Y-type address constant 
message appears before the diagnostic 
message section; the statements-flagged 
message appears after the diagnostics. 
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@ @ @ ® ©) ©) EXTERNAL SYMBOL DICTIONARY PAGE 1 


SYMBOL TYPE 1D ADDR LENGTH LD ID 


SAMPLR SD 01 000000 000388 














@) © 


EXAM SAMPLE PROGRAM PAGE 3 
Loc OBJECT CODE ADDRL AODR2 STMT SOURCE STATEMENT E OLFERB66 2/28/66 


000089 LO6+IHBOOO7 EQU * @) 
OOOOBA LOT+IHBOOOTA DS OH 

OOO00BA 0A23 108+ Svc 35 ISSUE SVC 

‘OO00BC 47FO CO6E OO07E 109 B EXIT SAMPLOT9 
QO00CO 9680 5008 00008 110 NOTTHERE OF LSWITCH,NGNE TURN ON SWITCH IN LEST ENTRY SAMPLONBN 























RELOCATION DICTIONARY 


CO Oe 3: @ 


POS.ID REL.1D FLAGS ADDRESS 








0001FC 
ol 01 oc 00020C 


ol Ol oc 00021CG 
Ql ol oc 000204 
ol 01 oc 000334 


00034C 


2@ © ® @ 


SYMBOL YALUE DEFN REFERENCES 


CROSS-REFERENCE PAGE 1 


BEGIN 00004 000000 0057 0154 OL156 0172 O182 0184 0218 
EXIT 00004 OOOCTE 0094 0109 
HIGHER 00002 COO0F4 0128 0123 
THBO0OCS 00001 C0007B 0091 0088 
THBOOOSA 00002 CD00TC 0092 0087 
IHBOOCT 00001 O00CB9 0106 0103 
FHBOOOTA 00002 OOO0BA 0107 0102 
LADDRESS 00004 O90000C 0078 





DIAGNOSTICS 
) 


STMT ERROR CODE MESSAGE 


Figure 4. Assembler Listing 


14 


EXTERNAL SYMBOI, DICTIONARY (ESD) 


This section of the listing contains the 
external symbol dictionary information 
passed to the linkage-editor in the object 
module. The entries described the control 
sections, external references, and entry 
points in the assembled program. There are 
five types of entries, shown in Table 3, 
along with their associated fields. The 
circled numbers refer to the corresponding 
heading in the sample listing (Figure 4). 


Table 3. Types of ESD Entries 


ee E RN ata ae, tS a i 
MOM MONLONON ROMERO} 
| SYMBOL TYPE ID ADDR LENGTH LDID| 


| | | 

}------- }------ $-=--4------ }-------- -----4 
| x {| SD |X [| X |[ & [i> 
}------- f------ }----}------ }-------- +----- 
| x } DD f|- | kX [| = | x | 
}-—---=~- ------ $----+------ +-------- 4-----4 
f x [| ER [| X | - [ - fe 3] 
}------- f------ $----}------ +-------- 4----- 
; - | Po [xX {| X¥ |[ & ie > fH 
ponnaa=— f------ $----+------ }-------- +-----| 
fo - [| cM {|x | KX [| & f - | 
}------- dees doteotocoses Bi ee ee fi erenenser 4 
{| The X indicates entries accompanying | 
| each type designation. | 
Ma a a ee ea J 

This column contains symbols that 


appeared in the name field of CSECT or 
START statements, as Operands of ENTRY 
and EXTRN statements, or in the operand 
field of V-type address constants. 


This column contains the type designator 
for the entry, as shown in the _ table. 
The type designators are defined as: 


SD -- names section definition. The 
symbol appeared in the name 
field of a CSECT or START state- 
ment. 


LD -- The symbol appeared as the oper- 
and of an ENTRY statement. 
external reference. The symbol 
appeared as the operand of an 
EXTRN statement, or was defined 
as a V-type address constant. 


ER -- 


unnamed control section defini- 


tion. 


PC == 


CM -- common control section defini- 


tion. 


(3)rnis column contains the external symbol 
dictionary identification number (ID). 
The number is a unique two digit hexa- 
decimal number identifying the entry. 
It is used by the LD entry of the ESD 


and by the relocation dictionary to 
cross reference to the ESD. 


()rhe column contains the address of the 
symbol (hexadecimal notation) for SD and 
LD type entries, and zeros for ER type 
entries. For PC and CM type entries, it 


indicates the beginning address of the 
‘control section. 
(5) this column contains the assembled 


length, in bytes, of the control section 
(hexadecimal notation). 


(*)this column contains, for LD type 
entries, the identification (ID) number 
assigned to the ESD entry that identi- 
fies the control section in which the 
symbol was defined. 


SOURCE AND OBJECT PROGRAM 


This section of the 
the source statements 
object program. 


listing documents 
and the resulting 


(7) this is the deck identification. It is 
the symbol that appears in the name 
field of the first TITLE statement. 


(®)this is the information taken from the 
operand field of a TITLE statement. 


(®)Listing page number. 


€°) This column contains the assembled 
address (hexadecimal notation) of the 
object code. 

(22) This column contains the object code 


produced by the source statement. The 
entries are always left-justified. The 
notation is hexadecimal. Entries are 
machine instructions or assembled con- 


Stants. Machine instructions are print- 
ed in full with a blank inserted after 
every four digits (two bytes). Con- 
stants may be only partially printed 


(see the PRINT assembler instruction in 
the Assembler Language publication). 


@2) these two columns contain effective 
addresses (the result of adding together 
a base register value and displacement 
value): 


1. The column headed ADDR1 contains the 
effective address for the first 
operand of an SS instruction. 


2. The column headed ADDR2 contains the 
effective address of the second 
operand of any instruction referenc- 
ing storage. 
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Both address fields contain six digits; error, and a diagnostic is placed 


however, if the high order digit is a zero, in the list of diagnostics. How- 
it is not printed. ever, when an error is encountered 
during the expansion of a macro- 

@3) this column contains the statement num- instruction (system or programmer 
ber. A plus sign (+) to the right of defined), the error indication 
the number indicates that the statement appears in place of the erroneous 
was generated as the result of macro- statement, which is not listed. 
instruction processing. The error indication appears fol- 
lowing the last statement listed 

This column contains the source program before the erroneous statement was 
Statement. The following items apply to encountered, and the associated 
this section of the listing: diagnostic message is placed in 


the list of diagnostics. 
a. Source statements are listed, 
including those brought into the 


program by the COPY assembler i. Literals that have been assigned 
instruction, and macro-definitions locations by a LTORG statement 
submitted with the main program appear in the listing following 
for assembly. Listing control the END statement. Literals are 
instructions are not printed, identified by the equals (=) sign 
except for the following case: preceding them. 


PRINT is listed when PRINT ON is 
in effect and a PRINT statement is 


encountered. j- If the END statement contains an 

operand, the transfer address 

b. Macro-definitions for system appears in the location column 
macro-instructions are not listed. (LOC). 


c. The statements generated as the 


result of a macro-instruction fol- ke. In the case of COM, CSECT, and 
low the macro-instruction in the DSECT statements, the location 
listing. field contains the beginning 
address of these control sections 

d. Assembler or machine instructions i.se., the first occurrence. 


in the source program that contain 
variable symbols are listed twice: 


as they appear in the source 1. For a USING statement, the loca- 
input, and with values substituted tion field contains the value of 
for the variable symbols. the first operand. 

e. Diagnostic messages are not listed m. For LTORG and ORG statements, the 
in-line in the source and object location field contains the loca- 
program section. An error indica- tion assigned to the literal pool 
tor, ***ERROR***#, appears follow- or the value of the ORG operand. 
ing the statement in error. The 
message appears in the diagnostic n. For an EQU statement the location 
section of the listing. field contains the value assigned. 

£f. MNOTE messages are listed in-line Oo. Generated statements always print 
in the source and object program in normal statement format. 
section. An MNOTE indicator Because of this, it is possible 
appears in the diagnostic section for a generated statement to occu- 
of the listing. The MNOTE message Py three or more continuation 
format is: severity code, message lines on the listing. This is 
text. unlike source statements which are 

restricted to two continuation 

g.- The MNOTE* form of the MNOTE lines. 


statement results in an in-line 
message only. An MNOTE indicator This field indicates the assembler level 
does not appear in the diagnostic and release number for the month it was 
section of the listing. issued, e.g., EOLFEB66 reads as Assem- 
bler E, first release of February 1966. 
h. When an error is found in a pro- 
grammer macro-definition, it is @e) current date (date run is made). 


treated like any other assembly 
error: the error indication 2) rdentification-sequence field from the 
appears after the statement in source statement. 
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RELOCATION DICTIONARY 


Se Sa 


This section of the listing contains the 
relocation dictionary information passed to 
the linkage editor in the object module. 
The entries describe the address constants 
in the assembled program that are affected 
by relocation. 


28) This column contains the external symbol 
dictionary ID number assigned to the ESD 
entry that describes the control section 
in which the address constant is used as 
an operand. 


2) this column contains the external symbol 
dictionary ID number assigned to the ESD 
entry that describes the control section 
in which the referenced symbol is 
defined. 


@0) The two-digit hexadecimal number in this 
column is interpreted as follows: 


First Digit -- a zero indicates that the 
entry describes an A-type 
address constant. 


“~ a one indicates that the 
entry describes a V-type 
address constant. 


Second Digit -- the first three bits of 
this digit indicate the 
length and sign of the 
address constant as fol- 





lows: 
Bits 0 and 1 Bit 2 
00 = 1 byte QO= + 
01 = 2 bytes 1=- 
10 = 3 bytes 
11 = 4 bytes 
@2) this column contains the assembled 
address of the field where the address 


constant is stored. 
CROSS-REFERENCE 


This section of the listing information 
concerns symbols -- where they are defined 
and used in the program. 


@2) this column contains the symbols. 


@3) This column states the length (decimal 
notation), in bytes, of the field occu- 
pied by the symbol value. 


address 


@4) this column contains either the 
a value to 


the symbol represents, or 
which the symbol is equated. 


25) This column contains the statement num- 


ber of the statement in which the symbol 
was defined. 


This column contains the statement num- 
bers of statements in which the symbol 
appears as an operand. 


The following notes apply to the cross- 
referencing section: 


e Symbols appearing in V-type address 
constants do not appear in the cross- 
reference listing. 


e A PRINT OFF listing control instruction 
does not affect the production of the 
cross-reference section of the listing. 


e Undefined symbols appear in the cross- 
reference section. However, only the 
symbol column and the reference column 
have entries. 


DIAGNOSTICS 

This section contains the diagnostic 
messages issued as a result of error 
conditions encountered in the program. 


Explanatory notes and the severity code for 
each message are contained in Appendix A. 


@) this column contains the number of the 
statement in error. 


@®) this column contains the message iden- 
tifier. 


This column contains the message. 


Example: 

STMT ERROR CODE MESSAGE 

101 IETO35 ADDRESSABILITY ERROR 
The following notes apply to the diag- 


nostics section: 


e An MNOTE indicator of the form MNOTE 
STATEMENT appears in the diagnostic 
section, if an MNOTE' statement is 
issued by a macro-instruction. The 
MNOTE statement itself is in-line in 
the source and object program section 
of the listing. 


e A message identifier consists of six 
characters and is of the form: 


ITETXxXx 


IET 
identifies the issuing agent as assem- 
bler E. 

xXX 

the 


is a unique number 


message. 


assigned to 
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PROGRAMMING CONSIDERATIONS 


This section consists of a number of 
discrete subjects about assembler language 
programming. 


SAVING AND RESTORING GENERAL REGISTER 
CONTENTS 


A problem program should save the values 
contained in the general registers upon 
commencing execution, and, upon completion, 
restore to the general registers these same 
values. Thus, as control is passed from 
the operating system to a problem program 
and in turn, to a subprogram, the status of 
the registers used by each program is 
preserved. This is done through use of the 
SAVE and RETURN system macro-instructions. 


The SAVE macro-instruction should be the 
first statement in the program. It stores 
the contents of registers 14 and 15, and 0 
through 12 in an area provided by the 
program pasSing control. When a problem 
program is given control, register 13 
points to an area in which the _ general 
register contents should be saved. 


If the program calls any subprograms, or 
uses any operating system services other 
than GETMAIN, FREEMAIN, ATTACH, and XCTL, 
it must first save the contents of register 
13, and then the address of an 18 full-word 
save area must be loaded into register 13. 
This save area is in the problem program 
and is used by any subprograms or operating 
system services called by the problem pro- 
gram. 


At completion, the problem program re- 
stores the contents of general registers 
14, 15, and 0-12 by use of the RETURN 
system macro-instruction (which also indi- 
cates program completion). The content of 
register 13 must be restored before execu- 
tion of the RETURN macro-instruction. 


The coding sequence that follows illus- 
trates the basic process of saving and 
restoring the registers. A complete dis- 
cussion of the SAVE and RETURN macro- 
instructions and the saving and restoring 


of registers is contained in IBM System/360 
Operating System: Control Program Services. 
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erence ets — ep re 1 
| Name {Operation |Operand | 
eee ha he ee ee | 
|BEGIN {SAVE | (144,12) | 
| {st [13, SAVEBLK+4 | 
| | LA }13,SAVEBLK | 
| Is | | 
| |- | | 
| {L }13,SAVEBLK+4 | 
| | RETURN } (14,12) | 
| SAVEBLK | DC {18F'0O* { 
apse ter eee eS ee Mee ee eS el ene J 
PROGRAM TERMINATION 

Completion of an assembler source 


program is indicated by using the RETURN 
system macro-instruction to pass control 
from the terminating program to the program 
that initiated it. The initiating program 
may be the operating system, or, if a 
subprogram issued the RETURN, the program 
that called it. 


In addition to indicating program com- 
pletion and restoring registers, the RETURN 
macro-instruction may also. pass a return 
code - a condition indicator that may be 
used by the program receiving control. If 
the return is to the operating system, the 
return code is compared against the condi- 
tion stated in the COND= parameter of JOB 
or EXEC statements. If return is to anoth- 
er problem program, the return code is 
available in general register 15, and may 
be used as desired. Register 13 should be 
restored before issuing the RETURN macro- 
instruction. ; 


The RETURN system macro-instruction is 
discussed in detail in the Control Program 
Services publication. 


PARM FIELD ACCESS 


Access to information in the PARM field 
of an EXEC statement is gained through 
general register 1. When control is given 
to the problem program, general register 1 
contains the address of a full word which, 
in turn, contains the address of the data 
area containing the information. 


The data area consists of a half word 
containing the count (in binary) of the 
number of information characters, followed 


by the information field. The information 
field is aligned to a full-word boundary. 
The following diagram illustrates this 
process. 


General Register 1 


—— Address of Full Word | 


Points 
to Full Word 














— Address of Data Area 
Points 


to 














Data Area 


bait in Binary | Information Field 














MACRO-DEFINITION LIBRARY ADDITIONS 


Source statement coding to be retrieved 
by the COPY assembler instruction, and 
macro-definitions may be added to the 
Macro-library. The IEBUPDAT utility pro- 
gram is used for this purpose. Details of 
this program and its control statements are 
contained in IBM System/360 Operating Sys- 
tem: Utilities. The following sequence of 
job control statements can be used to call 
the utility program and identify the needed 





data sets. It is assumed that the job 
control statements, IEBUPDAT program con- 
trol statements, and data are to enter the 


system via the input stream. 


//jobname JOB 
//stepname EXEC PGM=IEBUPDAT, PARM=NEW 
4/SYSUT2 DD DSNAME=SYS1.MACLIB, DISP=OLD 
//SYSPRINT DD SYSOUT=A 
4/SYSIN DD * 


IEBUPDAT control statements and source 
statements or macro-definitions to be 
added to the macro-library (SYS1.MACLIB) 


/* (delimiter statement) 


LOAD MODULE MODIFICATION-ENTRY POINT 
RESTATEMENT 


If the editing functions of the linkage 
editor are to be used to modify a load 


module, the entry point to the load module 
must be restated when the load module is 
reprocessed by the linkage editor. Other- 
wise, the first byte of the first control 
section processed by the linkage editor 
will become the entry point. To enable 
restatement of the original entry point, or 
designation of a new entry point, the entry 
point must have been identified originally 
aS an external symbol, i.e., appeared as an 
entry in the external symbol dictionary. 
External symbol identification is done 
automatically by the assembler if the entry 
point is the name of a control section or 
START statement; otherwise an assembler 
ENTRY statement must be used to identify 
the entry point name as an external symbol. 


When a new object module is added to or 
replaces part of the load module, the entry 
point is restated in either of three ways: 


e By placing the entry point symbol in 
the operand field of an EXTRN statement 
and an END statement in the new object 
module. 

e By using an END statement in the new 
object module to designate a new entry 
point in the new object module. 

e By using a linkage editor ENTRY state- 
ment to designate either the original 
entry point or a new entry point for 
the load module. 


Further discussion of load module entry 
points is contained in the linkage editor 
publication. 


OBJECT MODULE LINKAGE 


Object modules, whether Assembler, FOR- 
TRAN or COBOL generated, may be combined by 
the linkage editor to produce a composite 
load module provided each object module 
conforms to the data formats and Linkage 
conventions required. This topic discusses 
the use of the CALL system macro- 
instruction to link an assembler language 
"main" program to subprograms produced by 
FORTRAN and COBOL. + 


Figure 5 shows the statements used to 
establish the linkage from the assembler 
program to the called subprograms. 


1See the Control Program Services 
publication for additional details concern- 
ing linkage conventions and the CALL system 
macro-instruction. 
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SAVE (14,12) 
sT 13, SVAREA+ 4 
LA 13,SVAREA 


CALL name, (V1,V2,V3) ,VL 


L 13, SVAREA+4 
RETURN (14,12) 
SVAREA DC 18F'O* 
V1 DC (data) 
V2 pc (data) 
V3 DC (data) 
END 


The address of this program's (the calling program) save area is placed in general 
register 13 for use by the called subprogram. 


The symbol used for "name" in this statement is: 


1. The name of a subroutine or function, when linking to a FORTRAN written 
subprogram. 


2. The name defined by the following COBOL statements in the procedure division: 
ENTER LINKAGE. ENTRY'name'. 


3. The name of a CSECT or START statement, or a name used in the operand field of an 
ENTRY statement in an assembler subprogram. 


ce ee ee A ge a ee ce ee ee ee eee SS ee eee ee ee oe ond 


The order in which the parameter list is written must reflect the order in which the| 
called subprogram expects the argument. If the called routine is a FORTRAN written| 
function, the returned argument is not in the parameter list: a real or double| 
precision function returns the value in floating point register zero; an integer| 
function returns the value in general purpose register zero. | 

| 
CAUTION: When linking to FORTRAN written subprograms, consideration must be given to| 
the storage requirements of IBCOM (FORTRAN execution-time I/O and interrupt handling| 
routines) which accompanies the compiled FORTRAN subprogram. In some instances the] 
call for IBCOM is not automatically generated during the FORTRAN compilation. The | 
FORTRAN IV Library publication provides information about IBCOM requirements and| 
assembler statements used to call IBCOM. | 

| 
FORTRAN written subprograms and FORTRAN library subprograms allow variable length| 
parameter lists in linkages which call them; therefore all linkages to FORTRAN| 
subprograms are required to have the high-order bit in the last parameter in the] 
linkage set to 1. COBOL written subprograms have fixed length calling linkages; | 
therefore, for COBOL the high order bit in the last parameter need not be set to 1. | 

| 
This statement reserves the save area needed by the called subprogram. When control] 
is passed to the subprogram, register 13 contains the address of this area. | 
5 6 When linking to a FORTRAN or COBOL subprogram, the data formats declared in oe 
statements are determined by the data formats required by the FORTRAN or COBOL| 
subprograms. | 


Figure 5. Linkage Statements 
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If any input/output operations are per- 
formed by called subprograms, appropriate 
DD statements for the data sets used by the 
subprograms must be supplied. See the 
FORTRAN (E) Programmer's Guide for explana- 
tion of the DD statements used to describe 
data sets for FORTRAN programs and a de- 
scription of the special FORTRAN data set 
record formats. The COBOL (E) Programmer's 
Guide provides DD statement information for 
COBOL programs. 


DICTIONARY SIZE AND SOURCE STATEMENT 
COMPLEXITY 


The following material: (1) describes 
the composition of the assembler dictionar- 


ies and their entry sizes, and (2) de- 
scribes methods for determining if the 
limits on source statement complexity will 


be exceeded. 


Dictionary entries e.g., sequence symbol 
names or prototype symbolic parameters, 
vary in length. Therefore, the number of 
entries a dictionary can hold is determined 
by the types of entries. 


Source statement complexity -- the num- 
ber of symbols, characters, operators, 
delimiters, references to length attri- 
butes, self-defining terms, literals, and 
expressions appearing in a source statement 
-- determines whether or not the source 
statement can be successfully processed. 


DICTIONARIES USED IN CONDITIONAL ASSEMBLY 
AND MACRO-INSTRUCTION EXPANSION 


For the macro generator portion of the 
assembler to accomplish macro-instruction 
expansion and conditional assembly, two or 
more dictionaries must be constructed: a 
global dictionary and one or more _ local 
dictionaries. 


These dictionaries take two forms: one 
which is used at the time the dictionary 
entries are collected, i.e., picked up from 
the initial scan of the source program: and 
one which is used during the actual condi- 
tional assembly and macro generation pro- 
cess. The next five topics describe the 
global and local dictionaries at collection 
and generation time. 


Global Dictionary at Collection Time 


One global dictionary is built for the 
entire program. it contains macro- 
instruction mnemonics and global SET 
variable symbols. One entry is made for 
each unique global SET variable symbol. 
One entry is made for each macro- 
instruction mnemonic that is not defined in 
the program; two identical entries are made 
when the macro-instruction mnemonic is 
referred to before it is defined; three 
identical entries are made when the macro- 
instruction mnemonic is defined before it 
is referred to. The capacity of the global 
dictionary is 64 blocks of 256 bytes’ each. 
Each block contains complete entries. Any 
entry not fitting into a block is placed in 
the next block; the remaining bytes in the 
current block are not used. 


The size of each entry is shown in Table 
4, 


Table 4. Global Dictionary Entries at 
Collection Time 
(Se Merge 8 ee 1 
| Entry | Size | 
~----------------~-}--------------------- { 
|Each macro mnemonic|10 bytes plus | 
|operation code | mnemonic* | 
SS a Oi i 4 


+ 
}Each global SET {6 bytes plus name* | 
{variable symbol | | 


}------------------- 4_-------------------- 4 


{*One byte is used for each character in| 
| the name or mnemonic. | 


Fixed overhead for this dictionary is: 


8 bytes for the first block 
4 bytes for each succeeding block 
5 bytes for the last block 


There is a limit of 400 unique global 
symbols per assembly, regardless of the 
amount of storage available. 
Local Dictionary at Collection Time 

For the main portion of the program, 
(those statements not within a macro 
definition) one local dictionary is con- 
structed in which ordinary symbols 
(relevant to macro generation and condi- 
tional assembly), sequence symbols, and 
local SET variable symbols are entered. 


Relevant ordinary symbols are those which 
occur in macro-instructions or conditional 
assembly statements. In addition, one 
local dictionary is constructed for each 
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adifferent macro definition in the program. 


These local dictionaries contain one entry 
for each local SET variable symbol, 
sequence symbol, and prototype symbolic 


parameter declared within the macro defini- 
tion.+ The capacity of each local dictiona- 
ry is 64 blocks of 256 bytes’ each. Each 
block contains complete entries. Any entry 
not fitting into a block is placed in the 
next block; the remaining bytes in the 
current block are not used. Table 5 indi- 
cates the size of each type of entry and 
relates dictionary capacities to the struc- 
ture of any given program. 


Table 5. Local Dictionary Entries at Col- 
lection Time 

bo ee ei oa Pero oe ee a 1 
| Entry | Size | 
------------------- $---------------------| 
|Each sequence | | 
|symbol {10 bytes plus name* | 
-+----------------- }---------------------4 
|Each local SET | | 
[variable symbol |6 bytes plus name* | 
------------------- }---------------------| 
|Each prototype | 

{Symbolic parameter |5 bytes plus name* | 
------------------- +---------------------] 
[Each relevant | | 
Jordinary symbol | | 
Jappearing in the | | 
[main portion | | 
jof the program {10 bytes plus name* | 
}--------~---------- 4—--~----------------- { 


|*One byte is used for each character inj 
| the name or mnemonic | 


Fixed overhead for this dictionary is: 


8 bytes for the first block (if in the 
main program) 


32 bytes for the first block (if ina 
macro definition) 


4 bytes for each succeeding block 


5 bytes for the last block 


1If a sequence symbol is defined before it 
is referenced, an extra entry for the 
symbol is made. 
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Global Dictionary at Generation Time 


The structure of the global dictionary 
at generation time is shown in Table 6. 


Table 6. Global Dictionary Entries at Gen- 
eration Time 

(SS SS ee eae Ga 1 
| Entry | Size | 
~--------------------- }------------------] 
|Each macro mnemonic | | 
{operation code |3 bytes | 
~--------------------- }------------------| 
|Each global SETA | 

{symbol (dimensioned) |1 byte plus 4N* | 
~~----------~=-------- cae 


} 

|Each global SETA 
{symbol (undimensioned) |4 bytes | 
}~-------—--~——-----~--4------~------.---- 
|Each global SETB {1 byte plus (N/8)*| 
|symbol (dimensioned) |(N/8 is rounded to| 
| {the next highest | 
| | integer) | 


k 

{Each global SETB | | 
[symbol (undimensioned) {1 byte | 
}---------------------- }------------------ | 
JEach global SETC 


| 
{symbol (dimensioned) |1 byte plus 9N* | 


}---------------~------ }-------~---------- : 
|Each global SETC | | 
|symbol (undimensioned) |9 bytes | 
[---------------------- 4------------------ { 
|*N=dimension | 
a ah ee et et oe eee J 


Fixed overhead for this 
bytes plus word alignment. 


dictionary is 4 


Local Dictionary at Generation Time 


The structure of the local dictionary at 
generation time is shown in Table 7. 


Table 7. Local Dictionary Entries at Gen- 


eration Time 


Cae es es pep ee oe, asa ana Seah erated Reams 1 
| Entry | Size | 
~--~------------------ +--~--------------- 
|Each sequence symbol {5 bytes | 
}---------------------- $------------------ { 
|Each local SETA | 

| symbol peenene toned) {1 byte plus 4N* | 
~---------------- ews iee. t 


t 
|Each local SETB {1 byte plus (N/8)*| 
|symbol (dimensioned) |(N/8 is rounded to| 
| |the next highest | 


| | integer) | 
}~----~----------------}--~-=------------- { 
|Each local SETS | | 
{symbol py neemens Toned: |= byte | 
|------~--~----~--------}------------------ 1 
|Each local SETC | 
|symbol (dimensioned) {1 byte plus 9N* | 
~--------------------- $------------------4 


|Each local SETC | | 
| symbol Concaens Loned ae bytes | 
|~--------------------- }------------------ { 
|Each relevant ordinary| | 
{symbolt appearing in | | 
{the main portion of | | 

| 


jthe program {5 bytes 

es iat a a is lets a aT | 
|+For the main program Local Dictionary| 
| only those symbols which appear in| 
| macro-instruction operands or whose| 
| attributes are referenced are included. | 
| | 
|*N=dimension | 
be a So ar J 


Fixed overhead for this dictionary is 20 
bytes pilus word alignment. 


Additional Dictionary Requirements 


The generation time global dictionary 
and the generation time local dictionary 
for the main portion of the program must be 
resident in main storage. 


In addition, if the program contains any 
macro-instructions, main storage is 
required for the largest local dictionary 
of the macro-definitions being processed. 


Furthermore, during processing of macro- 
definitions containing inner macro- 
instructions, main storage is required for 


the generation time local dictionaries for 
the inner macro-instructions contained 
within the macro-definition. 


LOCAL DICTIONARY REQUIRE- 


In addition to those requirements 
the local dictionary of the 
each macro- 


MACRO-DEFINITION 
MENTS : 
specified for 
main portion of the program, 


definition local dictionary requires space 
for the entries shown in Table 8. 


Table 8. Macro-Definition Local Dictionary 
Parameter Table 
(oS ee ee ah la aia cal 1 
| Entry | Size | 
~----------------------- }----------------] 
|Each character string(1)|[3 bytes plus L | 
~----------------------- $---=------------] 
|Each hexadecimal, binary, | | 
{decimal, and character | | 
|self-defining term(2) |7 bytes plus L | 
------------------------ ----------------4 
|Each symbol (3) {9 bytes plus L | 
i ee aces {—.—--------------- 


| 
[10 bytes plus 2N{ 
| pbytes plus Y 


|N = Number of entries in sublist 
= Total length of the table entries in 


| 
4 
Length of entry in aie | 
| 
| formats 1,2,and 3 | 

J 


Fixed overhead for the macro-definition 
local dictionary parameter table is 22 
bytes. Each nested macro-instruction also 
requires space in its local dictionary for 
the following: 
Parameter pointer list 2 bytes plus 2N 

(N = the number of 


operands) 
Pointers to list in the 8 bytes plus word 
parameter table alignment 


MACRO MNEMONIC TABLE 


As the source statements are scanned, a 
table of macro-instruction mnemonics is 
constructed in which there is an entry for 
each macro-instruction used or defined in 
the program. The entries are made under 
the premise that every undefined operation 
is a system macro-instruction mnemonic. 
This table is then used to locate and edit 
system macro-definitions from the library. 


With 15,360 bytes of main storage 
available to the assembler, approximately 


430 distinct macro-instruction mnemonics 
can be handled. An entry in this table 
consists of nine bytes. In the event that 
this table overflows, processing continues 
with only those macro-instructions defined 
to the point of overflow. 


SOURCE STATEMENT COMPLEXITY 


The complexity of a source statement is 
limited by both the macro-generator and 
assembler portions of Assembler E. The 
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following topics provide the information 
necessary to determine if statement com- 
plexity limitations for either portion of 
the assembler are being exceeded. 


Macro-Generation and Conditional Assembly 
Limitations 


For any statement which: 


1. Is a 
ment 

2. Is a DC or DS statement 

3. Is an EXTRN statement 

4. Contains a sequence 
variable symbol 

5. Is not a macro-instruction or pro- 
totype statement 


conditional assembly state- 


symbol or a 


the total number of literal occurrences of 


6. Ordinary symbols (includes machine 
mnemonics, assembler mnemonics, 
conditional assembly mnemonics, 
and macro-instruction mnemonics) 

7. Variable symbols 

8. Sequence symbols 


must not exceed 35 in the name, operation, 
or operand fields respectively; and the 
number of literal occurrences of items 6, 
7, and 8 above must not exceed 36 for the 
entire statement. 


For macro-instructions 
statements the number of occurrences of 
ordinary symbols, variable symbols and 
sequence symbols must not exceed 35 in the 
name and operation fields combined, or in 
each operand unless the operand is a_sub- 
list in which case the limit is applied to 
each sublist operand. 


and prototype 


Examples of counts: 


&6B2 SETB (T'NAME EQ ‘W' OR "AA' 


count=4 


"6c. "A" EQ 


EXTRN A,B,C,6&C 
count=5 


Assembler Portion Limitations 


The 
ment must 


space required to process a state- 
not exceed 730 bytes for DC and 
DS statements, and 746 bytes for ail oth- 
ers. Buffering considerations may allow 
statements exceeding these requirements by 
up to 30 bytes to be processed. 


The following formulas (S, and Sa) are 
used to determine if statement complexity 


2u 


will exceed the limitations stated above. 
The statement must be tested against S, and 
S2 and must satisfy both. 


In general, ali statements can be proc- 
essed if they contain 50 or fewer terms. 
If a statement contains more than 50 terms, 
the formulas should be used to determine if 
the statement can be processed, or if the 
statement should be shortened using EQU 
assembler instructions. In the first exam- 
ple, if A+(B-C)*3 were equated to a symbol, 
that symbol could be used as the displace- 
ment field of the first operand in the 
example. 


Formula Sy: 


where 
N, = total number of bytes in name, 
operation, operand, and comment 
entries (the maximum value of N 
is 187) 


of operators and delimi- 
ters in the operand field, 
except equal (=), period (.), 
and apostrophe(') 


Na. = number 


Nj, = number of references to length 
attribute (L'SYMBOL) 


Nog = number of self-defining terms 
N = number of symbols (including*) 


N, = number of literal 


(maximum of 1) 


operands 


Example: 
NAME MVC A+ (B-C) *3(L'D,5),=15CL5"ABCDEFG' 


N N N N N N 
b d la sad s 1 

t Y + Y + + 
6S4=39 + 9 + 4(1 + 4) + 643 + 1) 
S4=92 


Formula S2: 


So=Npt9 (W{+Wot...+Wy) +D 


where: 

Np, = as defined in formula S, 

W =a weight associated with each 
expression in the statement. The 
subscript represents the expres- 
sion number; W, is the last 
expression. 

D = the number of expression delimi- 
ters 


W May equal 1, 2, 3, 4, or 5 and is 
a function of the number of 


unpaired relocatable terms 
appearing in each expression as 
follows: 


ee ere a are me 20 a ee) aD YD ce ES OD ee ee GS Re GE ae ee ee 


T 
| Number of Unpaired Terms | W | 
[-------------------------- $--------- { 
| 0, 1 | 1 | 
| Ze 3, fy 5 | 2 | 
| 6, 7, 8, 9 | 3 | 
| £0; Ly: i2y. 13 | 4 | 
| 14, 15, 16 | 5 | 
te eee eee eae ees Feces eee nee J 

The rules for counting expressions and 


expression delimiters are as follows: 


1. A comma is always an expression delim- 
iter, as is the terminating blank. 


2. Left and right parentheses can be part 
of an expression; or they can _ be 
expression delimiters. A left paren- 
thesis is an expression delimiter if 
it is not preceded by an arithmetic 
operator or a blank. A right paren- 
thesis is an expression delimiter if 
its paired left parenthesis is an 
expression delimiter. 


Example 1: 
NAME L 6,A+20*B(6) 


Np Wa Wa W3 D 
t + FY FF 4 
S2=16 + 9(1 + 1+ 1) + 4 
S2=47 
In this example the comma, the two  paren- 
theses, and the terminating blank are 
expression delimiters. There are three 


expressions in this example: 


(1) 6 
(2) A+20*B 
(3) 6 


Expressions 1 and 3 are absolute and there- 
fore have a weight (W) of 1. Expression 2 
may be absolute or simply relocatable and 
therefore has a weight (W) of 1. (B must 
be absolute or the expression is in error.) 


Example 2: 
MVC A+17*(C-D), (A+20) 


Np Wa We OD 
+ 1 
So=20 + 9(1 +1) + 2 


S2=40 


In this example the comma and the terminat- 
ing blank are the only expression delimi- 
ters and D=2. There are two expressions: 

A+17* (C-D) 


Expression 1 = with a 


weight (W) of 1 
Expression 2 = (A+20) with a 
(W) of 1 


weight 


Example 3: 


Mvc 20(5,3),16(5) 
Np Wi Wo Ws Wa Ws D 
' ¥ Y FY 4 t 
So=16 + 9(1 +1+4+41+ 212+ 12) «+ *'T7 
S2=68 


In this example there are 5 expressions (E) 
and 7 expression delimiters (ED). 


E,=20 ED, =( 
E2=5 ED2=, 
E3=3 ED3=) 
Ey=16 EDy=, 
Es5=5 EDs= ( 
ED6=) 
ED,=blank 
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This appendix lists the diagnostic mes- 
sages issued by the assembler. The messa- 
ges are listed by their number (001-109). 
Note: Explanations of the MNOTE messages 
issued by system macro-instructions are 
contained in the Messages and Completion 
Codes publication. 


IET001 DUPLICATION FACTOR ERROR 
Explanation: A duplication factor 
is not a positive absolute expres- 
sion, ot is zero ina literal. 


Severity Code: 12 


IETOO02 RELOCATABLE DUPLICATION FACTOR 


A relocatable expres- 
specify the 


Explanation: 
sion has been used to 
duplication factor. 


Severity Code: 12 


TETOO3 LENGTH ERROR 
Explanation: The length specifi- 
cation is out of permissible range 
or specified invalidly. 


Severity Code: 12 


IETOO4 RELOCATABLE LENGTH 


Explanation: A relocatable expres- 
sion has been used to. specify 
length. 
Severity Code: 12 

IETO05 S-TYPE CONSTANT IN LITERAL 
Severity Code: 8 

IETOO06 INVALID ORIGIN 
Explanation: The location counter 


has been reset to a value less than 
the starting address of the control 
section. 


Severity Code: 12 
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IETOO07 LOCATION COUNTER ERROR 


Explanation: The location counter 


has exceeded 231-1. 


Severity Code: 12 


IETOO8 INVALID DISPLACEMENT 
Explanation: The displacement in an 


explicit address does not fall with- 
in the range of 0 to 4095. 


Severity Code: 8 


IETOO9 MISSING OPERAND 


Severity Code: 12 


ITETO10 INCORRECT REGISTER SPECIFICATION 
Explanation: The value specifying 
the register is greater than 15, or 


an odd register is specified where 
an even register is required. 


Severity Code: 8 


IETO11 SCALE MODIFIER ERROR 


Explanation: The scale modifier is 


out of range. 


Severity Code: 8 


IET012 RELOCATABLE SCALE MODIFIER 


A relocatable expres- 
used to specify the 


Explanation: 
sion has been 


scale modifier. 


Severity Code: 8 


IETO13 EXPONENT MODIFIER ERROR 
Explanation: The exponent is not 
specified as an absolute expression 
or is out of range. 


Severity Code: 8 


IETOO1-IETO13 27 


ITETO14 


IETO15 


IETO16 


IETO17 


IETO18 


IET019 


IETO20 
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RELOCATABLE EXPONENT MODIFIER 


Explanation: A relocatable expres- 
sion has been used to specify the 
exponent modifier. 


Severity Code: 8 


INVALID LITERAL USAGE 


Explanation: A literal is used 
illegally. For example, it speci- 
fies a receiving field or a reg- 


ister. 


Severity Code: 8 


INVALID NAME 


Explanation: A name entry is incor- 


rectly specified. For example, it 
contains more than 8 characters, it 
does not begin with a letter, or has 
a special character imbedded. 
Severity Code: 8 

DATA ITEM TOO LARGE 

Explanation: The constant is too 


large for the data type or for the 
explicit length. 


Severity Code: 8 


INVALID SYMBOL 


Explanation: The symbol is speci- 
fied invalidly. For example, it is 
longer than 8 characters. 

Severity Code: 8 

EXTERNAL NAME ERROR 

Explanation: A cCSECT and DSECT 
statement have same name, or a sym- 


bol used more than once in EXTRN. 


Severity Code: 8 


INVALID IMMEDIATE FIELD 


Explanation: The value of the 
immediate operand exceeds 255, or 
the operand requires more than one 


byte of storage. 


Severity Code: 8 


IETO21 


IETO22 


IETO23 


IETO24 


IETO25 


IETO026 


IETO27 


SYMBOL NOT PREVIOUSLY DEFINED 


Severity Code: 8 


ESDTABLE OVERFLOW 


Explanation: The combined number of 


control sections and dummy sections 
plus the number of unique symbols in 
EXTRN statements and V-type con- 
stants exceeds 255. If overflow is 
due to a V-type constant, message 
IETO25 will also be issued. 
Severity Code: 12 

PREVIOUSLY DEFINED NAME 

Explanation: The symbol which 
appears in the name field has 
appeared in the name field of a 
previous statement. 

Severity Code: 8 

UNDEFINED SYMBOI 

Explanation: A symbol being ref- 


erenced has not been defined in the 
program. 


Severity Code: 8 


RELOCATABILITY ERROR 


Explanation: A relocatable or com- 
plex relocatable expression is spec- 
ified where an absolute expression 
is required, or an absolute expres- 
Sion or complex relocatable expres- 
Sion is specified where a relocata- 
ble expression is required. 


Severity Code: 8 


TOO MANY LEVELS OF PARENTHESES 


Explanation: An expression contains 
more than 5 levels of parentheses. 


Severity Code: 12 


TOO MANY TERMS 


Explanation: More than 16 terms are 
specified in an expression. 


Severity Code: 12 


IETO28 


IETO29 


ITETO30 


ITETO31 


IETO32 


IETO33 


IETO34 


IETO35 


REGISTER NOT USED 


Explanation: A register specified 
in a DROP statement is not currently 
in use. 


Severity Code: 4 


CCW ERROR 


Explanation: Bits 37-39 of the CCW 
are set to nonzero. 


Severity Code: 8 


INVALID CNOP 


Explanation: The operands 


invalid pair. 


are an 


Severity Code: 12 


UNKNOWN TYPE 


Explanation: desig- 


nation ina Dc, 


Incorrect type 
DS or literal. 


Severity Code: 8 


OP-CODE NOT ALLOWED TO BE GENERATED 


Severity Code: 8 


ALIGNMENT ERROR 


Explanation: Referenced address is 


not aligned to the proper boundary 
for this instruction. 

Severity Code: 4 

INVALID OP-CODE 

Explanation: Syntax error: more 
than 8 characters in operation 
field; not followed by a blank on 


first card, etc. 


Severity Code: 8 


ADDRESSABILITY ERROR 

Explanation: The referenced address 
does not fall within the range of a 
USING instruction. 





Severity Code: 8 


IET036 


IET037 


IETO38 


IETO39 


IETO4O 


NO OPERAND ALLOWED 


Severity Code: 4 


MNOTE STATEMENT 


Explanation: This indicates that an 
MNOTE statement has been generated 
from a macro definition. The text 
and severity code of the MNOTE 
statement will be found in line in 
the listing. 


ENTRY ERROR 


Explanation: A symbol in the oper- 
and of an ENTRY statement appears in 
more than one ENTRY statement, or is 
undefined, or is defined in a dummy 
section or in blank common, or is 
equated to a symbol defined by an 


EXTRN statement, or there are more 
than 100 ENTRY operands in the pro- 
gram. 
Severity Code: 8 

INVALID DELIMITER 
Explanation: This message can be 
caused by: 

1. Operands not separated by com- 

mas in assembler or machine 


instructions. 


2. Last operand not followed by a 
blank. 


3. Invalid sequence of operations 
and delimiters. 


4. Incomplete exponent specifi- 
cation in DC or DS statement. 


5. No data item specified between 
delimiters in a DC or DS state- 
ment. 


6. No right parenthesis after an 
explicit base register expres- 
sion in a S-type constant. 


7. Absence of comma, blank, or 
left or right parenthesis where 
required in a machine instruc- 
tion operand. 


Severity Code: 12 


STATEMENT TOO LONG 


Severity Codes 12 
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IETO41 


IETO42 


IETO43 


ITETO44 


IETO45 


IETO46 


IETO47 


IETO48 


ITETO49 
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UNDECLARED VARIABLE SYMBOL 


Explanation: A variable symbol is 
not declared in a SET symbol state- 
ment or in a macro-instruction pro- 
totype statement. 


Severity Code: 8 


SINGLE TERM LOGICAL EXPRESSION IS 
NOT A SETB SYMBOL 


Explanation: The single term logi- 
cal expression has not been declared 
as a SETB symbol. 


Severity Code: 8 


SET SYMBOL PREVIOUSLY DEFINED 


Severity Code: 8 


SET SYMBOL USAGE 
DECLARATION 


INCONSISTENT WITH 


A set symbol has been 
declared as undimensioned, but is 
subscripted, or has’ been dimen- 
sioned, but is unsubscripted. 


Explanation: 


Severity Code: 8 


ILLEGAL SYMBOLIC PARAMETER 


Explanation: The system variable 
symbol is used in a macro- 


instruction prototype statement. 


Severity Code: 8 


AT LEAST ONE RELOCATABLE Y-TYPE 
CONSTANT IN ASSEMBLY 


Severity Code: 4 


SEQUENCE SYMBOL PREVIOUSLY DEFINED 


Severity Code: 12 
SYMBOLIC PARAMETER PREVIOUS LY 


DEFINED OR SYSTEM VARIABLE SYMBOL 
DECLARED AS SYMBOLIC PARAMETER 


Severity Codes 12 


VARIABLE SYMBOL MATCHES A PARAMETER 


Severity Code: 12 


IETO50 


IETOS51 


IETO52 


IETO53 


IETO54 


IETO55 


IETO56 


INCONSISTENT GLOBAL DECLARATIONS 


A global SET variable 
symbol defined in more than one 
macro-definition, or defined ina 
macro-definition and in the source 
program, is inconsistent in SET type 
or dimension. 


Explanation: 


Severity Code: 8 


MACRO DEFINITION PREVIOUSLY DEFINED 


Explanation: Prototype operation 
field is the same aS a machine or 
assembler instruction or a _ previous 
prototype. 


Severity Code: 12 


NAME FIELD CONTAINS ILLEGAL SET SYM- 
BOL 


Explanation: SET symbol in name 
field does not correspond to _ SET 


Statement type. 


Severity Code: 8 


GLOBAL DICTIONARY FULL 


Explanation: The global dictionary 
is full, assembly terminated. See 
"Dictionary Size and Source State- 
ment Complexity." 


Severity Code: 12 


LOCAL DICTIONARY FULL 


Explanation: The local dictionary 
is full, assembly terminated. See 
"Dictionary Size and Source State- 
ment Complexity." 


Severity Code: 12 


INVALID ASSEMBLER OPTION(S) ON THE 
EXECUTE CARD 


Severity Code: 8 


ARITHMETIC OVERFLOW 


Explanation: The intermediate or 
final result of an expression has 


exceeded 231-1. 


Severity Code: 8 


IET057 


IETO58 


IETO59 


IETO60 


IETO61 


ITETO62 


IET063 


TETO64 


TET065 


SUBSCRIPT EXCEEDS MAXIMUM DIMENSION 


Explanation: SYSLIST or symbolic 
parameter subscript exceeds 200, or 


is negative, or zero, or SET 
subscript exceeds dimension. 


symbol 


Severity Code: 8 


ILLEGAL LTORG 


Explanation: LTORG appears in a COM 
or DSECT control section. 


Severity Code: 8 


UNDEFINED SEQUENCE SYMBOL 


Severity Code: 12 


ILLEGAL ATTRIBUTE NOTATION 
Explanation: L', S‘, or I‘* request- 
ed for a parameter whose type attri- 
bute does not allow these attributes 
to be requested. 


Severity Code: 8 


ACTR COUNTER EXCEEDED 


Severity Code: 12 


GENERATED STRING GREATER THAN 255 
CHARACTERS 

Severity Code: 8 

EXPRESSION 1 OF SUBSTRING IS ZERO OR 
MINUS 


Severity Code: 8 





EXPRESSION 2 OF SUBSTRING IS ZERO OR 
MINUS 


Severity Code: 8 


INVALID OR ILLEGAL TERM IN ARITHMET- 
Ic EXPRESSION 


Explanation: The value of a SETC 
symbol used in an arithmetic expres- 
sion is not composed of decimal 
digits; or, the parameter is not a 
self-defining term. 


Severity Code: 8 


IET066 


IET067 


IETO68 


IET069 


IETO70 


IETO71 


IETO72 


IETO73 


UNDEFINED OR DUPLICATE KEYWORD OPER- 
AND OR EXCESSIVE POSITIONAL OPERANDS 


Explanation: The same keyword oper- 
and occurs more than once in a 
macro-instruction, or a keyword is 
not defined in a prototype state- 


ment; or, in a mixed mode macro- 
instruction, more positional 
operands are specified than are 


specified in the prototype. 


Severity Code: 12 


EXPRESSION 1 OF SUBSTRING GREATER 
THAN LENGTH OF CHARACTER EXPRESSION 


Severity Code: 8 


GENERATION TIME DICTIONARY AREA 
OVERF LOWED 
Explanation: See “Dictionary Size 


and Source Statement Complexity." 


Severity Code: 12 


EXPRESSION 2 OF SUBSTRING GREATER 
THAN 8 CHARACTERS 


Severity Code: 8 


FLOATING POINT CHARACTERISTIC OUT OF 
RANGE 

Severity Code: 12 

ILLEGAL OCCURRENCE OF LCL, GBL OR 
ACTR STATEMENT 

Explanation: LCL, GBL, or ACTR 
statement not in proper place in 
program. 


Severity Code: 8 


ILLEGAL RANGE ON ISEQ STATEMENT 


Severity Codes 4 


ILLEGAL NAME FIELD 


Explanation: Either a statement 
which requires a name has been writ- 
ten without a name, or a statement 
has a name which is not allowed to 
have a name. 


Severity Code: 8 
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IETO74 


IETO75 


IETO76 


IETO77 


IETO78 


IETO79 


IETO80 


IETO81 
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ILLEGAL STATEMENT IN COPY CODE OR 
SYSTEM MACRO 


Severity Code: 8 


ILLEGAL STATEMENT OUTSIDE OF A MACRO 
DEFINITION 


Severity Code: 8 


SEQUENCE ERROR 


Severity Code: 12 


ILLEGAL CONTINUATION CARD 


Explanation: Either there are too 
Many continuation cards, or there 
are nonblanks between the begin and 
continue columns on the continuation 
card. 


Severity Code: 8 


MACRO MNEMONIC OP-CODE TABLE OVER- 
FLOW 


Explanation: See "Dictionary Size 
and Source Statement Complexity." 
Severity Code: 12 


ILLEGAL STATEMENT IN MACRO DEFINI- 
TION 


Explanation: This operation is not 
allowed within a macro-definition. 


Severity Code: 8 


ILLEGAL START CARD 


Explanation: Statements affecting 
or depending on the location counter 
have been encountered before a START 
statement. 


Severity Code: 8 


ILLEGAL FORMAT IN GBL OR LCL STATE- 
MENTS 

Explanation: An operand is not a 
variable symbol. 


Severity Code: 8 


ITETO82 


IETO083 


IETO84 


IETO85 


IET086 


IETO87 


IETO88 


ILLEGAL DIMENSION SPECIFICATION IN 
GBL OR LCL STATEMENT 
Explanation: Dimension is other 


than 1 to 255. 


Severity Code: 8 


SET STATEMENT NAME FIELD NOT A VARI- 
ABLE SYMBOL 


Severity Code: 8 


ILLEGAL OPERAND FIELD FORMAT 


Explanation: Syntax invalid; e¢.g., 
AIF statement operand does not start 
With a left parenthesis, or the 
operand of an AGO statement is nota 
sequence symbol, etc. 


Severity Code: 8 


INVALID SYNTAX IN EXPRESSION 


Explanation: Invalid delimiter, too 
Many terms in expression, too many 
levels of parentheses, or two opera- 
tors in succession. 


Severity Code: 8 


ILLEGAL USAGE OF SYSTEM VARIABLE 
SYMBOL 


Explanation: A system variable sym- 
bol appears in the name field of a 
SET statement, or is used ina mixed 
mode or keyword macro-definition, or 
is declared ina GBL or LCL state- 
ment, or is an unsubscripted 
&6SYSLIST in a context other than 
N' €SYSLIST. 


Severity Code: 8 


NO ENDING APOSTROPHE 


Explanation: There is an unpaired 
apostrophe in the statement. 


Severity Code: 8 


UNDEFINED OPERATION CODE 


Severity Code: 12 


ITETO89 


IETO90 


IETO91 


ITETO92 


IETO93 


IETO94 


IETO95 


IETO96 


INVALID ATTRIBUTE NOTATION 


Explanation: Syntax error; e.g., 
the argument of the attribute ref- 
erence is not a symbolic parameter 
inside a macro-definition. 

Severity Code: 8 

INVALID SUBSCRIPT 

Explanation: Syntax error; e€.9g., 
double subscript where single  sub- 


script is required or vice versa, no 
right parenthesis after subscript, 
etc, 


Severity Code: 8 


INVALID SELF-~DEFINING TERM 


Explanation: Value is too large or 
is inconsistent with the data type. 





Severity Code: 8 


INVALID FORMAT FOR VARIABLE SYMBOL 


Explanation: The first character 
after the ampersand is not alphabet- 
ic or the variable symbol contains 
more than 8 characters. (A single 
ampersand in a field or operand is 
assumed to start a variable symbol.) 


Severity Code: 8 


UNBALANCED PARENTHESES OR EXCESSIVE 
LEFT PARENTHESES 


Severity Code: 8 


INVALID OR ILLEGAL NAME OR OPERATION 
IN PROTOTYPE STATEMENT 
Severity Code: 12 


MESSAGE NOT DEFINED FOR THIS ERROR 
CODE 


MACRO-INSTRUCTION OR PROTOTYPE OPER- 
AND EXCEEDS 255 CHARACTERS IN LENGTH 


Severity Code: 12 


IETO97 


IETO98 


IETO99 


IET100 


INVALID FORMAT IN MACRO-INSTRUCTION 
OPERAND OR PROTOTYPE PARAMETER 


Explanation: This message can be 
caused by: 

1. Illegal "=" 

2. A single “"&" appears in the 


standard value assigned toa 
prototype keyword parameter. 


3. First character of a prototype 
parameter is not "6". 
4. Prototype parameter is a sub- 


scripted variable symbol. 


5. Invalid usage of alternate for- 


mat in prototype statement, 
C.ge, 
10 16 72 
PROTO &A,&B, 
or 
PROTO 6&A,6&B, x 
&C 
6. Unintelligible prototype param-— 
eter, e.g., “"&A*" or “&AEE," 
etc. 


7. (Illegal (non-assembler) charac- 
ter appears in prototype param- 
eter. 


Severity Code: 12 


EXCESSIVE NUMBER OF OPERANDS OR PAR- 
AMETERS 

Explanation: Either the prototype 
has more than 200 parameters or, the 
macro-instruction has more than 200 
operands. 


Severity Code: 12 


POSITIONAL MACRO-INSTRUCTION OPER- 
AND, PROTOTYPE PARAMETER OR EXTRA 
COMMA FOLLOWS KEYWORD 


Severity Code 12 


STATEMENT COMPLEXITY EXCEEDED 


Explanation: See “Dictionary Size 
and Source Statement Complexity." 


Severity Code: 8 


IETO74-IET100 33 


IET101 


IET102 


ITET103 


IET104 


IET105 


34 


EOD ON SYSIN 


Explanation: No END card before 
delimiter (/*) statement. 


Severity Code: 12 


INVALID OR ILLEGAL ICTL 


Explanation: The operands of the 
IcTL are out of range, or the ICTL 
is not the first statement in the 
input deck. 


Severity Code: 16 


ILLEGAL NAME IN OPERAND FIELD OF 


COPY CARD 
Explanation: Syntax error; e.g., 
symbol has more than 8 characters, 


or has an illegal character. 


Severity Code: 12 


COPY CODE NOT FOUND 

Explanation: The operand of a COPY 
statement specified COPY text which 
cannot be found in the library. 


Severity Codes 12 


EOD ON SYSTEM MACRO LIBRARY 


IET106 


IET107 


IETi08 


IET1L09 


Explanation: MEND statement not in 


macro definition. 


Severity Code: 12 


MESSAGE NOT DEFINED FOR THIS ERROR 
CODE 


INVALID OPERAND 


Explanation: Unrecognizable operand 
in PRINT statement. 


Severity Code: 4 


PREMATURE EOD 


Explanation: Indicates an internal 
assembler error; should not occur. 


Severity Code: 16 


PRECISION LOST 


Severity Code: 8 


The listing shown in this appendix 
results from assembling the source program 
documented in Appendix H of the Assembler 
Language publication. For easy reference 
to the explanations that appear in the 
section "The Assembler Listing,“ the head- 
ings on the listing are numbered. 


APPENDIX B: PROGRAM LISTING 


Since there were no errors in the assenm-— 
bly, a diagnostic list was not produced. 
Fach of the following pages represents one 
printer-produced listing page. 
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SYMBOL TYPE ID ADDR LENGTH LO ID 


SAMPLR SD G2 000000 000388 


EXTERNAL SYMBOL DICTIGNARY 


PAGE 


1 


@® © © 


EXAM SAMPLE PROGRAM PAGE 
@) @Q ©@®& (3) 
Loc OBJECT CODE ADDR1 ADDR2 STMT SOURCE STATEMENT E OLFEB66 2/28/66 
2 PRINT DATA SAMPTN02 
3 * SAMPLO03 
4 * THIS {S THE MACRO DEFINITION SAMPLID4 
5 * SAMPLONONS 
6 MACRO SAMPLING 
7 MOVE &TO,&FROM SAMPLONT 
8 .* SAMPLONB 
9 * DEFINE SETC SYMBOL SAMPLONO 
10 .* SAMPLOLO 
lt LCLC &TYPE SAMPLOLY 
12 .* SAMPLOI2 
13 o* CHECK NUMBER OF OPERANDS SAMPLO13 
14 .* SAMPLOL4 
15 ALF {N*GSYSLIST NE 2).ERRORL SAMPLOI5 
16 .* SAMPLOLG6 
17 .* CHECK TYPE ATTRIBUTES OF OPERANDS SAMPLOL7 
18 .* SAMPLOLS 
19 AIF (T*ETO NE T*EFROM)ERROR2 SAMPLOL9O 
20 AIF {T*GTO €Q *C* OR T*ETO EQ "G* OR TtETO EQ *K*).TYPECGK SAMPLOPN 
2i AIF {T*&TO EQ "D* OR T*ETO EQ *E* OR T*ETO EQ *H*).TYPEDEH SAMPLY?1 
22 AIF (T¢6TO EQ *F*).MOVE SAMPLO22 
23 AGO oe ERRORZ SAMPL923 
24 «TYPEDEH ANOP SAMPLO24 
25 .* SAMPLON25 
26 .* ASSIGN TYPE ATTRIBUTE TO SETC SYMBOL SAMPLN26 
27 «* SAMPLO?7 
28 GTYPE SeTc T*éTO SAMPLO928 
29 .MOVE ANOP SAMPLO29 
30 * NEXT TWO STATEMENTS GENERATED FOR MOVE MACRO SAMPLON30 
31 LETYPE 22&FROM SAMPLO3L 
32 ST&TYPE 2,&T0 SAMPLO32 
33 MEXIT SAMPLO33 
34 o* SAMPLN34 
35 .* CHECK LENGTH ATTRIBUTES OF OPERANDS SAMPLO35 
36 o* SAMPL°36 
37 »«TYPECGK AIF {L°ETO NE LYGFROM OR L*ETO GT 256) ERRORS SAMPLY37 
38 *% NEXT STATEMENT GENERATED FOR MOVE MACRO SAMPL138 
39 MVC &TQ, &FROM SAMPLO39 
40 MEXIT SAMPLO40 
41 .* SAMPLO4] 
42 .* ERROR MESSAGES FOR INVALID MOVE MACRO INSTRUCTIONS SAMPLN42 
43 .* SAMPLN43 
44 eERRORIL MNOTE 1+*EMPROPER NUMBER OF OPERANDS, NO STATEMENTS GENERATEN® SAMPLI44 
45 MEXIT SAMPL945 
46 -~ERROR2 MNOTE 1,*OPERAND TYPES DIFFERENT, NO STATEMENTS GENERATED® SAMPLO46 
47 MEXIT SAMPLN4T. 
48 sERRGR3 MNOTE le* IMPROPER QPERAND TYPES, NO STATEMENTS GENERATED? SAMPL148 
49 MEXIT SAMPLN49 
50 sERROR4 MNOTE Le* [IMPROPER OPERAND LENGTHSe NO STATEMENTS GENFRATFD® SAMPLO59 
$1 MEND SAMPLO51 
52 * SAMPLOS52 
53 * MAIN ROUTINE SAMPLO54 
54 * SAMPLO54 
000000 55 SAMPLR CSECT SAMPLOS5 
56 BEGIN SAVE (14912}05% SAMPLOSA 
000000 4TFO FOOA QO00A 57+ BEGIN 8 10(0,15) BRANCH: AROUND ID 
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EXAM 


ccc 


cocccs 
cccccs 
COOOCA 
coccce 
Q00010 
coooic 
000014 
coogco 
ccccls 
coocic 
ogGgcec 
c00000 


000024 
GOOd2A 


ococ3ac 
G00034 
OGOO3E 


00003C 


000042 
000046 
Gooc4ac 


aocosc 
00GG5G 
000C54 


‘GooCcsé 


C0005 
acoged 
GCCOEE 
Co00dG 
CGGGTE 
cooc7s 
coccic 
cooc7c 
CGOCTE 


GGOC&2 
CGOC&E 
CCCC8A 


ccocec 
GCGGaC 
COgESC 
Goocs2 
600094 
coccse 
GOOgA4 
COCOAC 
cooca4 


SAMPLE PROGRAM 


GaJeECT CODE AD0R1 


cs 
C2c5C7CS05 
g9cec DOOC 
cscc 


SCDC CCBE 
9657 C3SC 


45€0 COBE 
9180 CCBC ooocc 
4710 CoBC 


D200 1063 5CC&8 00003 
OzC2 10CC 5¢CS GaCccd 


5€2€ 5CCC 
5C2C 1CC4 
£756 CCCE 
OS5SEF C24C CCFO 00250 
477C CCIC 
O55F C33C C1EQ 00340 
4710 CCT 


451C CCéC 

CC27 

cccc 

CLEZE2ZC5C4C 20305 
0940E2C104D703C5 
4CO70S0é6CTDIC104 
4CEZE4C3C3C5E2ZE2 
C6E403 


GA23 
5800 &0B8 


seec OCCC 
41FC COGc 
O7FE 


4510 CCAA 

GC29 

ccce 
CilE2E2C504C203C5 
D940E2C1040703C5 
4COWSC6CTOSC104 
4CE4D5EZE4C3C3C5 
EZE2C6E4D3 


ABDR2 


aoooc 
o00cs 
003A0 
QOOCE 
oo0co 


0000s 


00009 


ocooc 
00004 
00018 
cc100 
Qoosc 
OCLEO 
o00é8c 


oco7c 


acocs 


ooooc 
cco00 


QOGOBA 


STMT SOURCE STATENEAT 


58+¢ 
59+ 
60+ 
61 
62 
63 
64 
65 
66 MORE 
o7 
68 
69 
70 
7T1L+* 
72+ 
73 
T4+# 
75+ 
716 
T7+* 
78+ 
719+ 
80 LISTLOOP 
81 
82 
83 
84 
85 
B6t 
87+ 
Bat 
89+ 
90+ 


91+1HB0005 
92+LHBOOO5SA 
93¢ 

94 EXIT 

95 

96+ 

97+ 

98+ 

99 * 
100 NOTRIGHT 
101+ 
1L02#NOTRIGHT 
103+¢ 

104+ 

105+ 


Cc 
cc 
STM 
BALR 
USING 
sT 
LM 
US ING 
BAL 
™ 
8G 
USING 
MOVE 
NEXT 
MYC 
HOVE 
NEXT 
MVC 
MOVE 
NEXT 
L 

ST 
BXLE 
cCLe 
BNE 
cic 
BNE 
hTO 
CNOP 
BAL 
dC 
cc 
oc 


EQu 
cS 
SVC 

A 
RETUR 
re 

LA 

BR 


wT 
CNOP 
BAL 
oc 
cc 
oc 


AL1(5) 

CLS*BEGIN® IDENTIFIER 

14212912413) SAVE REGISTERS 

R12e0 ESTABLISH ADDRESSABILITY OF PROGRAM 


@) 


E O1FEB66 


¥,R12 AND TELL THE ASSEMBLER WHAT BASE TO USE 


13¢SAVE1L3 


R5eR7eACLISTAREAs 16eLISTEND) LOAD LIST AREA PARAMETERS 


LIST eR5 REGISTER 5 POINTS TO THE LIST 
R14,SEARCH FIND LIST ENTRY IN TABLE 
SWITCHyNONE CHECK TO SEE [IF NAME WAS FOUND 


NOTTHERE BRANCH IF NOT 

TABLE,R1 REGISTER 1 NOW POINTS TO TABLE ENTRY 

TSWITCHsLSWITCH MOVE FUNCTIONS 
STATEMENT GENERATED FOR MOVE MACRO 

TSWITCHsLSWITCH 

TNUMBER sLNUMBER FROM LIST ENTRY 
STATEMENT GENERATED FOR MOVE MACRO 

TNUMBEReL NUMBER 

TADORESS»LADDRESS TO TABLE ENTRY 
TwO STATEMENTS GENERATED FOR MOVE MACRO 

2,LADDRESS 

2eTADORESS 


R5eRG,y MORE LOOP THROUGH THE LIST 
TESTTABL( 240), TABLAREA 

NCTRIGHT 

TESTLIST(96),LESTAREA 

NOTRIGHT 

®ASSEMBLER SAMPLE PROGRAM SUCCESSFUL ® 
04 

1,10HBOOO5A BRANCH AROUND MESSAGE 

AL2( 1HB0005-*} MESSAGE LENGTH 

At2(0) 

C* ASSEMBLER SAMPLE PROGRAM SUCCESSFUL* MESSAGE 


* 
Ok 
35 ISSUE SVC 
R13¢SAVE13 
N (14912) ¢RC=0 
14912512013) RESTORE THE REGISTERS 
1540(0,03 LOAD RETURN CODE 
14 RETURN 


"ASSEMBLER SAMPLE PROGRAM UNSUCCESSFUL* 

O24 

Le IRBOOO7A BRANCH AROUND MESSAGE 

AL2( 1HBOOOT7T-*) MESSAGE LENGTH 

AL2(03 

C8 ASSEMBLER SAMPLE PROGRAM UNSUCCESSFUL® MESSAGE 


@ 


PAGE 2 


2/28/66 


©) 


SAMPLO57 
SAMPLO58 
SAMPLO59 
SAMPL060 
SAMPLO61 
SAMPLO62 
SAMPLO63 
SAMPLO64 
SAMPLO65 
SAMPLOG66. 


SAMPLO67 


SAMPLO68 


SAMPL069 
SAMPLO70O 
SAMPLO7L 
SAMPLO72 
SAMPLO73 
SAMPLOT4 


SAMPLO75 
SAMPLO76 


SAMPLOT77 
SAMPLOT8 


 @® © © 


EXAM SAMPLE PROGRAM PAGE 3 
Loc OBJECT CODE ADDR1L ADDR2 STMT SOURCE STATEMENT E OLFFB66 2/28/66 
0000B9 LO6#+IHBOOOT = EQU * 
OOOQOBA 107#fHBOOO7A DS OH @ 
OOOOBA 0423 108+ SVC 35 {ISSUE SVC 
QOOOBC 47FO CO6E OOOTE 109 8 EXIT SAMPLO79 
0000C0 9680 5008 00008 LLO NOTTHERE Of LSWITCH,NONE TURN ON SWETCH IN LIST ENTRY SAMPLOBO 
0000C4 47FO C028 00038 111 8 LISTLOOP GO BACK AND LOOP SAMPLOBL 
0000C8 00000000 112 SAVE13 oc Feoe SAMPLOR2 
ao000cc 00 113 SWITCH oC x*00! SAMPLOB3 
000080 114 NONE EQU X*80¢ SAMPLO84 
115 * SAMPLO8S 
116 * BINARY SEARCH ROUTINE SAMPLO86 
117 € SAMPLOAT. 
ooogocdD 00 
OOOOCE 94%7F COBC ooocc 118 SEARCH NI SWITCH,255-NONE TURN OFF NOT FOUND SWITCH SAMPLO88 
0000D2 9813 C39C 003 AC 119 iM RlyR3y=F°128y4,128* LOAD TABLE PARAMETERS SAMPLOB9 
000006 4111 COEO OOOFO 120 LA RieTABLAREA-16(R1) GET ADDRESS OF MIDDLE ENTRY SAMPLO90 
OQOODA 83830 0001 ooooL 121 LOOP SRL R3,1 DIVIDE INCREMENT AY 2 SAMPLO91 
OOOODE D507 5000 L0C8 00000 00008 122 cLe CNAME, TNAME COMPARE LIST ENTRY WITH TABLE ENTRY SAMPLO92 
O0O0E4 4720 COE4 OCOF4 123 BH HIGHER BRANCH IF SHOULD BE HIGHFR IN TABLE SAMPL993 
OOOOES O78E 124 BCR 8,R14 EXIT tf FOUND SAMPLO94 
125 SR R1.R3 OTHERWISE IT IS LOWER TN THE TABLE XSAMPLO95 
OGOCEA 1813 SO SUBTRACT INCREMENT SAMPL996 
QOQQEC 4620 COCA OOODA 126 BcT R2,L00P LOOP 4 TIMES SAMPLOOT 
OOOOFO 47FO COEA OOOFA 127 8 NOT FOUND ARGUMENT IS NOT IN THE TABLE SAMPLO98 
OOOOF4 1A13 128 HIGHER AR RL»R3 ADO INCREMENT SAMPLO99 
O0OOF6 4520 COCA OOODA 129 BCT R2,L00P LOOP 4 TIMES SAMPLIO0N 
QOOOFA 9680 COBC ooocc 130 NOTFOUND Of SWITCH,NONE TURN ON NOT FOUND SWITCH SAMPLIOL 
OOOOFE O7FE 131 BR R14 EXIT SAMPLLO? 
132 * SAMPL103 
133 * THIS IS THE TABLE SAMPL104 
134 * SAMPL105 
000100 135 DS oD SAMPL106 
000100 0000000000000000 136 TABLAREA OC XL8*O* ,CLB*ALPHA® SAMPL107 
000108 CiLD3D7C 8C 1404040 
000110 0000000000000000 137 boc XLB"O"', CLE*BETA® SAMPL108 
000118 C2C5E30140404040 
000120 0000000000000000 138 oc XL8°O",CLBE*DELTA® SAMPL109 
000128 C4C5D3E3C1404040 
000130 0000000000000000 139 oc XL8*0*,CL8*EPSILON® SAMPLILO 
000138. C5D7E 20903060540 
000140 0000000000000000 140 oc XL8*°0* sCLB*ETA* SAMPLI11 
000148 C5E3C 14040404040 
000150 0000000000000000 141 oc XL8°O* »CLE*GAMMAt SAMPL11L2 
000158 C7C1D4D4C1404040 
000160 0000000000000000 142 oc XL8°0*,CLB*IOTA® SAMPLI13 
000168 C€9D6E3C 140404040 
000170 0000000000000000 143 oc XLB°O'sCLE*KAPPA® SAMPLI14 
000178 02C1D707C1404040 
OcoLsO 0000000000000000 144 oc XL8*O0* ,CLB*LAMBDA® SAMPLI15 
0002188 03C1D4C204C 14040 
00019G 0000000000000000 145 oc XL8°0"»CLE*MUF SAMPLIL4 
000198 D4E4404040404040 
0001A0 0000000000000000 146 oc KL8*°0*,CLE8*NUE SAMPLIIL7 
0001A8 0D5E4404040404040 
0co1B0 0000000000000000 147 bc XL8"O*,CLE*OMICRON® SAMPL118 


OCO1L88 D06D4C9C 3D9D60540 
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EXAM 


Loc 


0001C0 
0001C8 
000100 
000108 
QOOLEO 
QOO1ES 


O001FO 
OOO1LF8 
000200 
000208 
000210 
000218 
000220 
000228 
000230 
000238 


‘000240 


000248 


000250 
000250 
000258 
000260 
000268 
000270 
000278 
000280 
000288 
000290 
000298 
0002A0 
000248 
000280 
000288 
0002c0 
0002C8 
0002D0 
000208 
000zEC 
0002E8 
0002FO 
0002F8 
000300 
000308 
000310 
000318 
000320 
000328 
000330 
000338 


OBJECT CODE 


SAMPLE PROGRAM 


CO . 


ADDRL AODDR2 STMT 


SOURCE STATEMENT 


0000000000000000 148 
07C 8C 94040404040 
0000000000000000 149 
E2C9C 70401404040 
0000000000000000 150 
ESC 5E3C 140404040 
; 151 * 
152 * 
152 * 
03C 104C2C4C 14040 154 LISTAREA 
0A400001000000000 
E€9C5E3€ 140404040 155 
O5000005000000DA 
E3C 8C5E3C 1404040 156 
0200C02D00000000 
E3C1E44040404040 157 
0000000C00000001 
D3C 9E2E 340404040 158 
1F00610100000000 
C1030 7C 801404040 159 LISTEND 
0000000100000078 
160 * 
161 * 
162 * 
163 
0000010000000078 164 TESTTABL 
€10307C 8C1404040 
0000000000000000 165 
C2C5E3C 140404040 
0000000000000000 166 
C4C5D3E3C 1404040 
gag0cgcocod00000 167 
C50 7E2C 903060540 
000000CC00000000 168 
C5E3C1 4040404040 
0000000000000000 169 
C7C10404C 1404040 
0000000000000000 170 
C9D6E3C 140404040 
0000000000000000 171 
02€10 70701404040 
00001D0AG0000000 172 
03C 104C 2C04€14040 
0000000000000000 173 
D4E4404040404040 
0000000000000000 174 
D5E 4404040404040 
0000000000000000 175 
DéD4C 9C 309060540 
o0ca0ccdd00000000 176 
D7C 8C 94040404040 
0000000000000000 177- 
£2€9C 704C1404040 
00000505000000DA 178 
E9C5E3C 2140404040 
179 * 


oc 
oc 
oc 


XL8*0*,CLS*PHI® 
XL8*°0",CLE*SIGMA® 


XL8°0*,CLE*ZETA® 


THIS 1S THE LIST 


oc 
oc 
oc 
oc 
oc 
oc 


CL8* LAMBDA yX*0A*, FL 3°29", AC BEGIN) 
CL8*ZETA* »X*05" ¢FL3°5",A(LOOP) 
CLE*THETA® sX*02%,FL3°45",A(BEGING 
CLB* TAU" s X*00%, FL3*0%, AT 1) 
CLOPLIST*,X* LES yFL 39465", A(0) 

CLB* ALPHA» X*00%e FL 3° 1% AC 123) 


THIS IS THE CONTROL TABLE 


DS 
oc 


oc 
oc 
oc 
oc 
oc 
oc 
be 
oc 
oc 
oC 
oc 
oc 
oc 


oc 


oD 
FL3°1L",X*00",AC123),CLS*ALPHA® 


KL8*0*,CLE*BETA® 
XLB*0",CLE*DELTA® 
XL8*O*,CLE*EPSILONS 
XL8*O*,CLE*ETA® 
XL8°0*,CLB"*GAMMA® 
XL8*O*,CLB"°IOTA® 
XLB"Ot ,CLE*KAPPA® 
FL3*29* .X* OA sAC BEGIN) ,CLE*LAMBDAt 
XL8°O*,CL8*MUt 
XL8'O',CLE*NUS 
XL8°0*,CLB*OMICRON¢ 
XL8*0*,CLE*PHI! 
XLB*O*,CLE*SIGMA® 


FL3*5*,X*O5* AC LOOP) CLE*ZETA® 


PAGE 4 
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E OLFEB66 ss a 
SAMPLI19 
SAMPL120 
SAMPLL2L 
SAMPLL22 
SAMPL123 
SAMPL124 
SAMPL125 
SAMPL126 
SAMPL127 
SAMPL128 
SAMPL129 
SAMPL130 
SAMPLI31 
SAMPL132 
SAMPL133 
SAMPL134 
SAMPLI35 
SAMPL136 
SAMPL137 
SAMPL138 
SAMPL139 
SAMPL 140 
SAMPLI41 
SAMPL142 
SAMPL143 
SAMPLL44 
SAMPL145 
SAMPL146 
SAMPLL4T 
SAMPL148 
SAMPL149 


SAMPLI59 


a 


Loc 


000340 
000348 
000350 
000358 
000360 
000368 
000370 
000378 
000380 
000388 
000390 
000398 


aoocoo 
000001 
000002 
000003 
000005 
000006 
a00007 
oo000c 
000000 
OOQO0E 
OO000F 


000000 
000000 
000008 
000009 
oo000c 


000000 
000000 
000003 
000004 
000008 
000000 
0003A0 
0003A8 
0003AC 
000384 


® 


SAMPLE PROGRAM 


® QO ©® 


OBJECT CODE AODDRL ADDR2 STMT 


180 

181 
03C1D4C2C4C 14040 182 
0A00001000000000 
E9C5E3C 140404040 
05000005000000DA 
E3C 8C 5E3C 1404040 
8200002D00000000 
E3C 1E 44040404040 
8000000000000001 
03C 9E 2E 340404040 
9F00010100000000 
C103D 7C 8C 1404040 
000000010000007B 


183 
184 
185 
186 
187 


188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 


203, 


204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
000001F 000000010 219 
00000240 
0€00008000000004 
00000080 


220 


SOURCE STATEMENT 


* 
* 
TESTLIST 


* 
* 
+ 
RO 
RL 


R2 


R3 

R5 

R6 

RT 

R12 

R13 

R14 

R15 

* 

* 

* 

LIST 
LNAME 
LSWITCH 
LNUMBER 
LADORESS 
* 

x 

* 
TABLE 
TNUMBER 
TSWITCH 
TADDRESS 
TNAME 


THIS IS THE CONTROL LIST 


oc 
oc 
oc 
oc 
oc 
oc 


THESE 


€QU 
EQu 
EQU 
EQU 
EQU 
EQu 
EQU 
EQU 
EQu 
EQU 
EQU 


CLE" LAMBDA’, X*0A*, FL3°29" ,AC BEGIN) 
CLB*ZETA* »X*05",FL3°S*, A{ LOOP) 
CLE" THETA* »X*82*,FL3°45* -A( BEGIN) 
CLE*TAUS se X*80",FL39O",ACL) 
CLEB*LIST* »X* 9F%, FL3°465*% ,A(0) 

CLO" ALPHA® »X# 00%, FL3®L°, A123) 


ARE THE SYMBOLIC REGISTERS 


THIS [TS THE FORMAT DEFINITION OF LIST ENTRYS 


OSECT 
os 
OS 
os 
DS 


THIS 


DSECT 
oS 

OS 

os 
os 
ENO 


cL8 
c 
FL3 
F 


IS THE FORMAT DEFINITION OF TABLE ENTRYS 


FL3 

c 

F 

cL8 

BEGIN 

sAILISTAREAs 1L6,LISTEND) 


=F*128¢4,128° 
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E OUFER66 2/28/66 


SAMPL1I51 
SAMPL15? 


SAMPL153- 


SAMPL154 
SAMPL155 
SAMPL156 
SAMPLI57 
SAMPL158 


SAMPLI59 
SAMPLI69 
SAMPL161 
SAMPL162 
SAMPL163 
SAMPL 164 
SAMPL165 
SAMPL 166 
SAMPL167 
SAMPL168 
SAMPL169 
SAMPLIT70 
SAMPLI7! 
SAMPLL72 
SAMPLL73 
SAMPLIT74 
SAMPLLTS 
SAMPL176 
SAMPLI77 
SAMPLI78 
SAMPL179 
SAMPLI18N 
SAMPL181 
SAMPLI182 
SAMPL183 
SAMPL184 
SAMPL185 
SAMPL186 
SAMPL187 
SAMPL188 
SAMP3189 


Program Listing 
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POS.1D 


OL 
ol 
ol 
01 
01 
01 
01 
a1 
o1 
ol 


REL.IO 


ol 
01 
ol 
OL 
01 
ol 
OL 
QL 
QL 
QL 


FLAGS 


oc 
oc 
oc 
oc 
oc 
oc 
oc 
oc 
oc 
oc 


RELOCATION DICTIONARY PAGE 1 


ADDRESS 


OOOLFC 
00020C 
00021C 
0002D4 
000334 
00034C 
00035C 
00036C 
0003A0 
0003A8 


CROSS—REFERENCE 


@ @ ® ®@ 


SYMBOL LEN VALUE DEFN REFERENCES 


BEGIN 00004 000CCO 0057 0154 0156 0172 O182 0184 0218 
EXIT 00004 OQOOO7TE 0094 0109 

HIGHER 00002 COOCF4 0128 0123 

IHB0005 00001 000078 0091 0088 

THBOO05A 00002 GO00aTC 0092 0087 

THBO007 00001 000089 0106 0103 

THBOOCTA 00002 COOOBA 0107 0102 

LADDRESS 00004 CO000C 0209 0078 

List . 00001 000000 0205 0065 

LISTAREA 00008 QOOLFO 0154 0064 0083 0219 
LISTEND 00008 000240 0159 0064 0219 
LISTLOOF 00004 000038 0080 OlL1 

LNAME 00008 000000 0206 0122 

LNUMBER 00003 000009 0208 0075 


Loap 00004 OOOODA 0121 0126 0129 0155 0178 0183 
LSWITCH 00001 000C08 0207 0072 0110 

MORE 00004 0000L8 0066 0080 

NONE 00001 C00080 0114 0067 OLLO 0118 0130 


NOTFOUND 00004 QOOOFA 0130 0127 
NOTRIGHT 00004 OO0OSC 0102 0082 0084 
NOTTHERE 00004 QO00CO 0110 0068 


RO 00001 000000 0191 

Ri Good: COOCOL 0192 0069 0119 O820 0120 0125 0128 
R12 00001 QO000C 0198 0061 0062 

R13 00001 COO00D 0199 0094 

R14 00001 OOOO0E 0200 0066 0124 0131 

R15 00001 QOOO0OF 0201 

R2 00001 000002 C193 0126 0129 

R3 00001 000003 0194 0119 0121 0125 0128 
R5 00001 ¢G00005 0195 0064 0065 0080 

R6 00001 000006 0196 0080 

R7 00001 000007 0197 0064 


SAMPLR 00001 cO0000 0055 

SAVE13 00004 0000C8 0112 0063 0094 
SEARCH 00004 OOOGCE 0118 0066 
SWITCH o0ool OCaCccc 0113 0067 O118 0130 
TABLAREA 00008 000100 0136 O008L 0120 
TABLE o0002 000000 0213 0069 
TADDRESS 00004 000004 0216 0079 
TESTLIST Q0008 000340 0182 0083 
TESTTABL 00003 C00250 0164 0081 

TNAME 00008 Gd0dcds 0217 0122 
TNUMBER 00003 000000 0214 007s 
TSWITCH 00001 000003 0215 Q072 


NO STATEMENTS FLAGGED IN THIS ASSEMBLY 
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Assembler cataloged procedures 8 
for assembling 8 
for assembling and linkage editing 9 
for assembling, linkage editing and 
execution 11 
input stream statements (see cataloged 
procedures) 
overriding 11 
Assembler data sets 6 
ddname SYSIN- 6 
ddname SYSLIB 6 
ddname SYSPRINT 6 
ddname SYSPUNCH 6 
ddSySuTl 6 
ddname SYSUT2 6 
ddname SYSUT3 6 
Assembler listing 13 
cross-reference 17 
diagnostics 17 
external symbol dictionary 15 
relocation dictionary 17 
source and object program 15 
statistical messages 13 
Assembler options 5,6 
default entry 6 


Cataloged procedures 8 


ASMEC 8,9 
input stream statements 8 
ASMECL 9,10 


input stream statements 9 
ASMECLG 11,12 
input stream statements i1 
device naming conventions 8 
overriding 11,12 
COND= parameter 6,12,18 


Data sets 

(see assembler data sets) 
Diagnostic messages 27 
Dictionaries 21 

additional requirements 23 

global 21,22 

local 21,22 


General register (13) 18 
Global dictionary 

(see dictionaries) 
Global symbols (limit) 21 


IEBUPDAT 19 
Input stream 5 


INDEX 


input stream statements 
(see cataloged procedures) 
sequential scheduling level 5 


Job control statements 5 
Job steps 5 


Listing, assembler 

(see assembler listing) 
Local dictionary 

(see dictionaries) 


Macro-definition local dictionary 
requirements 23 
Macro library additions 19 
Macro mnemonic table 23 
Messages 
diagnostic 29 
statistical 13 


Object module linkage 19,20 
CALL macro-instruction 19,20 
input/output operations 21 
linkage statements 20 
to COBOL 20 
to FORTRAN 20 

Options, assembler 5,6 
default entry 6 

Overriding cataloged procedures 
EXEC statements 11 
DD statements 11 
examples 11,12 


11,12 


PARM field access 18 
Procedure (definition) 5 
Program termination 18 

RETURN macro-instruction 18 


Return Codes 6,7 


Saving and restoring general register 
contents 18 
example of 18 
Severity code 
relation to return code 7 
for diagnostic messages 27 
Source statement complexity 23 
assembler limitations 24 
defined 21 
macro-generation and conditional 
assembly limitations 24 
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